Anexar um comprovante de identidade ou endereço

Execute esta etapa depois que a identidade ou o endereço existir e os arquivos exigidos tiverem sido enviados por meio de create_encrypt_files com o tipo de comprovante selecionado. Use um identificador vigente obtido de get_proof_types, que corresponda ao requisito e à categoria da entidade.

Guarde identity_id e address_id obtidos de create_document; o UUID do perfil é diferente. A compatibilidade com a anexação posterior de comprovantes de endereço a perfis recém-criados ainda está em análise. Se o endereço for rejeitado, consulte o portal ou o suporte antes de tentar novamente.

Criar o comprovante

Use uma conta habilitada da API da MultiTEL e seu endereço IP autorizado. Os exemplos usam credenciais de autenticação HTTP Basic obtidas de variáveis de ambiente; siga as convenções de autenticação do seu tipo de conta. Envie as solicitações por HTTPS. Verifique tanto a resposta HTTP quanto o campo do objeto JSON status.code; erros da aplicação podem ser recebidos com HTTP 200. Os exemplos abaixo são fictícios.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

Campos da solicitação
Campo	Significado
`entity_type`	Use identities ou addresses. Escolha a categoria que corresponda tanto à entidade de destino quanto aos arquivos enviados.
`entity_id`	Identificador da identidade ou do endereço pertencente à sua conta. Use o identificador retornado pelo seu fluxo de documentos; não o substitua por um número de telefone nem por um identificador de documento sem relação com esse fluxo.
`proof_type_id`	Identificador do tipo de comprovante selecionado. Mantenha-o compatível com o envio dos arquivos e com o requisito.
`encrypted_file_ids`	Array JSON não vazio de identificadores de arquivo retornados por create_encrypt_files. Os arquivos devem pertencer à mesma conta, não ter expirado e corresponder à categoria da entidade. Não se trata de uma lista de caminhos de arquivos locais.

Também são aceitos dados de formulário com repetições do campo encrypted_file_ids[]. Prefira um array JSON real ou um array de formulário; não envie um array codificado em JSON como um valor escalar comum de formulário.

Guardar o identificador do comprovante

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

Uma resposta bem-sucedida confirma a criação da associação do comprovante. Ela não confirma a aprovação da identidade ou do endereço, a validação de todos os requisitos do país nem a ativação de um número de telefone.

Erros e arquivos enviados expirados

O código 500 da API é usado quando faltam dados de entrada obrigatórios, ocorrem falhas da operadora ou a resposta da operadora é inválida. O código 404 é usado quando a entidade de destino não está associada à conta atual, o tipo de comprovante é inválido, um arquivo enviado não pode ser encontrado para esta conta e categoria ou expirou, ou não restam identificadores de arquivo utilizáveis. Leia status.msg junto com o código.

Envie novamente qualquer arquivo obrigatório que tenha expirado, usando a categoria de comprovante correta, antes de anexá-lo. Se algum dos arquivos fornecidos for inválido, este manipulador interrompe a execução antes de enviar a solicitação de criação do comprovante. Nenhuma chave de idempotência é disponibilizada: se o tempo limite for excedido, verifique o documento existente no portal antes de repetir a anexação.