Validar Pagamento 3DS

POST/v1/payments/3ds/validate-v2

Valida uma transação com 3DS, confirmando a autenticação e finalizando o processo de validação do pagamento.

Validar Pagamento 3DS

Parâmetros

Exemplo de requisição

{
  "authenticationTransactionId": "dbe5a61a-836d-45dd-82c1-52d0c5e3c010",
  "paymentToken": "eyJhbGciOiJIUzI1NiJ9[...]9oBbxbtuE_vuu6UzU-Mp5BjK2FNp5XAfoDy2uQ"
}

Retorno (200)

Exemplo de resposta

{
  "paymentAuthorization": {
    "returnCode": "0",
    "description": "Sucesso",
    "paymentId": "020006204409231653310000023790740000000000",
    "authorizationCode": "026603",
    "orderNumber": "3979908797721",
    "amount": 1111,
    "releaseAt": "2020-09-23T16:53:34+00:00"
  }
}

Dicionário de dados

Status do 3DS

Os status do 3DS mostram o que ocorreu durante a autenticação. Cada código identifica uma situação, como falha na verificação, indisponibilidade do serviço ou rejeição pelo banco emissor. A tabela abaixo explica o significado de cada retorno.

Status	Significado	Descrição
AUN	Não autenticada	A autenticação ou a verificação da conta falhou. A transação foi negada.
AUU	Autenticação indisponível	Problemas técnicos ou outros erros impediram a autenticação ou a verificação da conta.
AUA	Tentativa comprovada	A autenticação não foi concluída, mas há uma prova de que houve uma tentativa.
AUR	Rejeitada pelo emissor	O banco emissor rejeitou a autenticação ou a verificação da conta.
AUD	Desafio desacoplado	A autenticação exige um desafio em um fluxo separado, chamado decoupled.

Erros

Para recusas retornadas pelo emissor ou adquirente, consulte também os Códigos de resposta do autorizador. Esses códigos identificam o resultado da transação e não devem ser confundidos com os status HTTP.

As respostas de erro conhecidas estão abaixo. Os retornos observados em homologação estão identificados separadamente dos exemplos documentados; as respostas podem variar conforme o ambiente e a configuração.

Exemplo documentado

[
  {
    "tag": "3DS Fail",
    "description": "eci: 00 - threeDsVersion: 2.1.0 - threeDsStatus: AUTHENTICATION_SUCCESSFUL - veresEnrolled: U - directoryServerErrorCode: 203"
  }
]

Ver validações observadas em homologação

Requisição com corpo JSON vazio ou identificador sintético. O retorno abaixo mostra a validação realizada em homologação.

[
  {
    "tag": "AuthenticationTransactionId",
    "description": "ID da transação de autenticação 3ds é requerido"
  },
  {
    "tag": "PaymentToken",
    "description": "token de pagamento é requerido"
  }
]

Campos da resposta de erro

A tabela reúne os campos presentes nos exemplos acima. Uma resposta HTTP sem corpo não inclui esses campos.