Resposta do Desafio 3DS

Este endpoint lida com a etapa de desafio do 3D Secure, permitindo que o titular do cartão conclua qualquer autenticação adicional necessária e retornando o resultado final da autenticação.

Fazendo Requisição

A chamada deverá ser feita utilizando o método POST.

POST/v1/card_payments/threeds_challenge_result

Campos da Requisição

Campo	Tipo	Descrição	Obrigatório
authentication_transaction_id	string	transactionId recebido via webhook enviado pelo emissor	Sim
request_id	string	Id da requisição recebido no setup	Sim

HTTP Request Body

  {
    "authentication_transaction_id": "wIUn1fbxiVYgivema352",
    "request_id": "C2E689A9CCF9454881A77FD84D600FD320251023112352722"
  }

Campos da Resposta

Campo	Tipo	Descrição
code	string	Código de resposta do resultado da transação.
msg	string	O valor de autenticação do titular do cartão para a sessão de autenticação 3D Secure.
cavv	string	O valor de autenticação do titular do cartão para a sessão de autenticação 3D Secure.
xid	string	O identificador de transação atribuído pelo Directory Server para autenticação. Only used for Visa transactions.
specification_version	string	A versão 3DS usada para autenticação.
directory_server_transaction_id	string	O ID da transação do servidor de diretório é gerado pelo servidor de diretório durante a autenticação.
three_ds_server_transaction_id	string	O ID de transação do servidor threeDS é gerado pelo servidor de diretório durante a autenticação.

Sucesso

Após a chamada, é retornado um JSON com o status 200.

HTTP 200 Response Body - Exemplo

{
  "code": "WDtw66nc9Bk1vMEHoMT0",
  "msg": "42C46CD74D1845D698107DAAD84875DF20240220153054822",
  "cavv": "AJkBBkhgQQAAAE4gSEJydQAAAAA=",
  "xid": "AJkBBkhgQQAAAE4gSEJydQAAAAA=",
  "specification_version": "2.1.0",
  "directory_server_transaction_id": "fb0deacf-2885-4dd7-a4d4-bedcf9ff52ba",
  "three_ds_server_transaction_id": "7606430740976386303814"
}

Erros

Em caso de erros, será retornado um json com o atributo error especificando o motivo de a operação ter sido invalidada.

HTTP 400 Response Body - Exemplo

{
  "errors": [
    {
      "code": "MSG_NOT_SUPPORTED",
      "msg": "Not supported"
    }
  ],
  "request_token": "EE4F8B5BC25A46B080F11D34B9CFAFFF",
  "multiacq_id": "001"
}

HTTP 422 Response Body - Exemplo

{
  "errors": [
    {
      "code": "INVALID_INPUT_CARD_METHOD",
      "msg": "request must include only slugToken, slugStoredCard, or card data. Please refer to the documentation."
    }
  ],
  "request_token": "7C2E9D3869F34F3CA5CC2C5CFAB4B6E2",
  "transaction_status": "REJECTED",
  "multiacq_id": "001"
}