Docs
Referência da API3DS

Abrir sessão 3DS

Abre a sessão de coleta de dados do dispositivo para uma tentativa de cobrança de crédito. O `session_token` vai ao navegador (SDK `DM3DS`) e volta na criação da cobrança em `paymentMethodOptions.creditCard.threeDs.sessionToken`. Validade de 30 minutos, uso único. Esta rota usa `snake_case`. Erros trazem o código em `title`.

POST
/v1/3ds/device-data-sessions

Abre a sessão de coleta de dados do dispositivo para uma tentativa de cobrança de crédito. O session_token vai ao navegador (SDK DM3DS) e volta na criação da cobrança em paymentMethodOptions.creditCard.threeDs.sessionToken. Validade de 30 minutos, uso único.

Esta rota usa snake_case. Erros trazem o código em title.

Autenticação

ApiKey
headerAuthorization<token>

A chave de API crua, sem prefixo: kpa_test_sk_… no sandbox e kpa_live_sk_… em produção. Use apenas no servidor.

Corpo da requisição

application/json
  1. body
amount*integer

Valor na menor unidade da moeda. Igual ao amount da cobrança.

Intervalo1 <= value
currency*string

Igual à moeda da cobrança.

transaction_scope?string

Escopo da conta definido no credenciamento. Não depende da moeda.

Padrão"Domestic"
Valores aceitos"Domestic""Offshore"

Corpo da resposta

Sessão aberta.

application/json
  1. response
session_token*string
Padrão (regex)^3ds_sess_[0-9A-HJKMNP-TV-Z]{32}$
expires_at*string

Até sete casas de fração de segundo.

Formatodate-time
Exemplo de requisição
curl -X POST 'https://g6idryo27h.execute-api.us-east-1.amazonaws.com/v1/3ds/device-data-sessions' \  -H 'Content-Type: application/json' \  -d '{  "amount": 10000,  "currency": "BRL",  "transaction_scope": "Domestic"}'
Exemplo de resposta
{  "session_token": "3ds_sess_9J4W2C7X5N8QK2R4T6Y8V0H2M4P6A1B3",  "expires_at": "2026-09-08T15:30:00.1234567Z"}