Serviço de consulta de transação
Essa chamada permite que o 3DS Requestor consulte o status de uma transação. Essa operação deve ser usada pelo 3DS Requestor caso haja problemas no recebimento do CRes. Retornaremos status, ECI e CAVV, ou seja, o que é necessário para prosseguir com uma autorização.
#
Detalhes da chamada- Recurso:
/v2/transaction/{ID da transação 3DS Server}
- Método HTTP:
GET
- Resposta HTTP OK:
200
- Formato da requisição: não há parâmetros de requisição
- Formato da resposta:
JSON
- Parâmetros de cabeçalho:
Parâmetro | Descrição | Formato | Obrigatório |
---|---|---|---|
merchant_id | Código da loja no 3DS Server. Os códigos de produção e certificação serão diferentes. | < 15 AN | SIM |
merchant_key | Chave de autenticação da loja no 3DS Server. As chaves de produção e certificação serão diferentes. | < 80 AN | SIM |
#
ExemplosAbaixo estão alguns exemplos de chamada do serviço de consulta utilizando a ferramenta cURL.
Requisição:
Resposta:
#
Exemplo com cancelamento de challengeAbaixo está um exemplo utilizando challenge cancel na resposta
Requisição:
Resposta:
#
Parâmetros de respostaEm caso de sucesso, o código de resposta HTTP será 200
. Qualquer outro código deve ser interpretado como erro. Na tabela abaixo está a descrição dos parâmetros de resposta do serviço de consulta de transações:
Parâmetro | Descrição | Formato |
---|---|---|
brand_id | ID da bandeira | < 4 N |
eci | Indicador de comércio eletrônico | < 2 N |
device_channel | Canal do dispositivo.
| < 2 N |
challenge_cancel | Indicador que informa ao ACS e DS que a autenticação foi cancelada.
| = 2 AN |
message_version | Versão utilizada na transação (essa versão deve ser utilizada na requisição do CRes) | < 8 AN |
three_ds_server | ||
trans_id | ID da transação 3DS Server | = 35 AN |
status | Status no 3DS Server. Saiba mais. | = 3 AN |
authentication | ||
value | Valor da autenticação (CAVV) | < 28 AN |
error | ||
code | Código do erro. Saiba mais. | < 3 N |
component | Indica qual componente identificou o erro.
| = 1 AN |
description | Descrição do erro | < 2048 AN |
detail | Detalhamento do erro | < 28 AN |