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âmetroDescriçãoFormatoObrigatório
merchant_idCódigo da loja no 3DS Server. Os códigos de produção e certificação serão diferentes.< 15 ANSIM
merchant_keyChave de autenticação da loja no 3DS Server. As chaves de produção e certificação serão diferentes.< 80 ANSIM

Exemplos#

Abaixo estão alguns exemplos de chamada do serviço de consulta utilizando a ferramenta cURL.

Requisição:

curl
--request GET "https://mpi-homolog.softwareexpress.com.br/3ds-server/v2/transaction/123456789-aaaa-bbbb-cccc-ddddddddddd"
--header "merchant_id: xxxxxxxxxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--verbose

Resposta:

{
"three_ds_server": {
"trans_id": "12345678-1234-1234-1234-123456789012",
"status": "AUY"
},
"brand_id": "2",
"eci": "05",
"device_channel": "02",
"authentication": {
"value": "1234567890123456789012345678"
},
"message_version": "2.2.0"
}

Exemplo com cancelamento de challenge#

Abaixo está um exemplo utilizando challenge cancel na resposta

Requisição:

curl
--request GET "https://mpi-homolog.softwareexpress.com.br/3ds-server/v2/transaction/123456789-aaaa-bbbb-cccc-ddddddddddd"
--header "merchant_id: xxxxxxxxxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--verbose

Resposta:

{
"three_ds_server": {
"trans_id": "12345678-1234-1234-1234-123456789012",
"status": "AUY"
},
"brand_id": "2",
"challenge_cancel": "01",
"eci": "05",
"device_channel": "02",
"authentication": {
"value": "1234567890123456789012345678"
},
"message_version": "2.2.0"
}

Parâmetros de resposta#

Em 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âmetroDescriçãoFormato
brand_idID da bandeira< 4 N
eciIndicador de comércio eletrônico< 2 N
device_channelCanal do dispositivo.
  • 01 = aplicativo (APP)
  • 02 = navegador (BRW)
< 2 N
challenge_cancelIndicador que informa ao ACS e DS que a autenticação foi cancelada.
  • 01 = O portador do cartão realizou o cancelamento
  • 03 = Transação expirou. Fluxo Decoupled
  • 04 = Transação expirou no ACS
  • 05 = Transação expirou no ACS. Primeiro CReq não foi recebido pelo ACS
  • 06 = Erro na transação
  • 08 = Transação expirou no 3DS SDK
  • 09 = Mensagem de erro em resposta a mensagem do CRes enviada pelo ACS
  • 10 = Mensagem de erro em resposta a mensagem do CReq enviada pelo ACS
= 2 AN
message_versionVersão utilizada na transação (essa versão deve ser utilizada na requisição do CRes)< 8 AN
three_ds_server
trans_idID da transação 3DS Server= 35 AN
statusStatus no 3DS Server. Saiba mais.= 3 AN
authentication
valueValor da autenticação (CAVV)< 28 AN
error
codeCódigo do erro. Saiba mais.< 3 N
componentIndica qual componente identificou o erro.
  • C = 3DS SDK
  • S = 3DS Server
  • D = DS
  • A = ACS
= 1 AN
descriptionDescrição do erro< 2048 AN
detailDetalhamento do erro< 28 AN