1. Configurar 3DS

posthttps://sandbox-api.rebornpay.io/v1/transactions/threeds/setupAuth obrigatória

Primeiro passo do fluxo 3DS: inicia o 3DS para um cartão. Devolve requestId/referenceId — repasse-os na etapa 2 (Autenticar 3DS).

Headers

X-Api-Keystringrequired

API Key do seller (header)

Body

application/json

cardobjectrequired

cardTokenstringoptional

Token de cartão já tokenizado em chamada anterior (`POST /v1/cards/tokenize` ou `card.tokenize: true`)

tokenstringoptional

Token dos Card Fields (`tokenize()`), o `pm_…` já salvo numa cobrança Stripe anterior, ou alias do Card Vault quando vault=CARD. Não envie PAN neste campo. No reuso Stripe não envie PAN, validade nem CVV.

vaultstringoptional

Cofre de tokenização. Use CARD para aliases do Card Vault do seller. Omita para PAN, `token` dos Card Fields ou `pm_` / `tok_` legado em `number`.

numberstringoptional

PAN de teste no sandbox. Legado: também aceita PaymentMethod (`pm_...`) ou Token Stripe (`tok_...`) quando `token` não é enviado. Em produção internacional prefira `card.token`.

holderNamestringoptional

Nome do titular impresso no cartão

expirationMonthstringoptional

Mês de expiração (MM)

expirationYearstringoptional

Ano de expiração (YYYY ou YY)

cvvstringoptional

Código de segurança (CVV) ou alias do Card Vault quando vault=CARD

lastDigitsstringoptional

Últimos 4 dígitos do cartão (obrigatório com Card Vault — o alias não revela last4)

binstringoptional

BIN (6 dígitos) quando o vault não revela o PAN

tokenizebooleanoptional

Quando dados crus são informados: true tokeniza o cartão antes da venda (reuso futuro, `cardToken` retornado na resposta); false envia o cartão para uso único, sem gerar token reutilizável.

Responses

200OK

codestringrequired

Código de status do setup

Example: PENDING_AUTHENTICATION

accessTokenstringrequired

Token de acesso para as etapas seguintes do 3DS

Example: eyJ...

deviceDataCollectionUrlstringrequired

URL para coleta de dados do dispositivo (device fingerprint)

Example: https://centinelapistag.cardinalcommerce.com/V2/Cruise/Collect

referenceIdstringrequired

ID de referência da sessão 3DS

Example: ref_abc123

requestIdstringrequired

ID da requisição de autenticação

Example: req_abc123

cardAcquirerstringoptional

Identificador opaco da sessão de cartão. Repasse o valor recebido nas etapas seguintes, se presente.

Example: card

curl -X POST 'https://sandbox-api.rebornpay.io/v1/transactions/threeds/setup' \  -H 'X-Api-Key: $API_KEY' \  -H 'Content-Type: application/json'

200Response example

{
  "code": "PENDING_AUTHENTICATION",
  "accessToken": "eyJ...",
  "deviceDataCollectionUrl": "https://centinelapistag.cardinalcommerce.com/V2/Cruise/Collect",
  "referenceId": "ref_abc123",
  "requestId": "req_abc123",
  "cardAcquirer": "card"
}