ENOQ PayDocs
v3

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

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"
  }
]

Observado 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.