GET Resposta do Desafio 3DS

1. Consulte o resultado da autenticação 3DS VIA API

GET/v1/card_payments/threeds/{operation_session_id}

Para obter o resultado do 3ds via API, o cliente deve fazer uma requisição com o operation_session_id retornado pelo SDK.

Requisição de Consulta

{
  "operation_session_id": "8f250597d1964683abb21a58241468c4"
}

Sucesso

Após a execução do SDK, o resultado é retornado no objeto result. Em caso de sucesso, o campo three_ds_data contém todos os dados necessários para a venda com 3DS.

Resposta de Sucesso

{
  "success": true,
  "status": "SUCCESS",
  "provider": 2,
  "operation_session_id": "8f250597d1964683abb21a58241468c4",
  "threeds_flow": "CHALLENGE",
  "three_ds_data": {
    "operation_session_id": "8f250597d1964683abb21a58241468c4",
    "id": "0b47b037-5360-42e2-8b61-2d95605a53b7",
    "xid": "de25ed0c-b4c6-49ec-bd69-2f8478219068",
    "eci": "02",
    "cavv": "kBMkIS6TvtjesABke//Be5hhJqAk",
    "secure_version": "2.2.0",
    "directory_server_transaction_id": "de25ed0c-b4c6-49ec-bd69-2f8478219068",
    "three_ds_server_transaction_id": "0b47b037-5360-42e2-8b61-2d95605a53b7",
    "trans_status": "SUCCESSFUL"
  }
}

Erros

Em caso de erro, retornará um objeto com detalhes do erro.

Resposta de Erro

{
"version": "V4",
"application_version": "6.43.10",
"server_date": "2026-05-15T00:59:15+00:00",
"ticket": "eeeca721ef28451585eaca64884715ee",
"status": "ERROR",
"answer": {
  "error_code": "INT_935",
  "error_message": "Invalid authentication id",
  "detailed_error_message": "Invalid input id [value=8f250597d1964683abb21a58241468c4]",
  }
}

Finalizando o Pagamento com 3DS

Após o SDK retornar success: true, utilize o objeto three_ds_data no campo three_ds_data da requisição de criação de pagamento:

POST /v1/card_payments — Exemplo

{
  "card_payment": {
    "amount": 1000,
    "currency": "BRL",
    "payment_type": "credit",
    "installments": 1,
    "card_number": "4970115000000228",
    "card_holder_name": "JOHN DOE",
    "card_expiration_date": "12/29",
    "card_security_code": "123",
    "card_holder_document": "12345678909",
    "card_holder_email": "cliente@example.com",
    "card_holder_phone": "11999999999",
    "three_ds_data": {
      "operation_session_id": "8f250597d1964683abb21a58241468c4",
      "id": "0b47b037-5360-42e2-8b61-2d95605a53b7",
      "xid": "de25ed0c-b4c6-49ec-bd69-2f8478219068",
      "eci": "02",
      "cavv": "kBMkIS6TvtjesABke//Be5hhJqAk",
      "secure_version": "2.2.0",
      "directory_server_transaction_id": "de25ed0c-b4c6-49ec-bd69-2f8478219068",
      "three_ds_server_transaction_id": "0b47b037-5360-42e2-8b61-2d95605a53b7"
    }
  }
}

Importante: operation_session_id e id são campos diferentes. operation_session_id é o ID da sessão criada no CreateSession, enquanto id é o ID da autenticação 3DS retornado na consulta de sessão.

Campos do three_ds_data

Campo	Tipo	Descrição
operation_session_id	string	ID da sessão 3DS criada.
id	string	ID da autenticação 3DS — diferente do operation_session_id. Pode ser usado para consultar o resultado.
xid	string	ID da transação de autenticação incluída pelo MPI ao estabelecimento (pode conter caracteres especiais). Utilizado somente para bandeira Visa.
eci	string	Código retornado ao MPI pelas bandeiras que indica o resultado da autenticação do portador junto ao Emissor. Transações de débito devem ser obrigatoriamente autenticadas.
cavv	string	Código do criptograma utilizado na autenticação da transação e enviado pelo MPI do estabelecimento (pode conter caracteres especiais).
secure_version	string	Versão do 3DS usado no processo de autenticação pelo MPI.
directory_server_transaction_id	string	ID da transação de autenticação incluída pelo MPI ao estabelecimento (pode conter caracteres especiais).
three_ds_server_transaction_id	string	ID da transação do servidor 3DS gerado durante a autenticação.
trans_status	string	Status da transação de autenticação. Exemplo: SUCCESSFUL.