Tokenizar cartão

posthttps://sandbox-api.rebornpay.io/v1/cards/tokenizeAuth obrigatória

Tokeniza um cartão para reuso em vendas futuras, sem repassar PAN aberto novamente. Devolve `cardToken` — use-o em `card.cardToken` no `POST /v1/transactions`. Alternativa a enviar `card.tokenize: true` direto em `POST /v1/transactions`, útil quando você quer tokenizar o cartão sem criar uma venda no mesmo momento.

Headers

X-Api-Keystringrequired

API Key do seller (header)

Body

application/json

buyerIdstring · uuidrequired

ID do buyer (comprador) dono do cartão

cardHolderNamestringoptional

Nome do titular impresso no cartão

cardNumberstringrequired

Número do cartão (PAN), apenas dígitos

cardExpirationDatestringrequired

Data de expiração no formato MMyyyy

cardSecurityCodestringoptional

Código de segurança (CVV)

tokenizationModestringoptional

`TOKENIZED_CARD`, `STORED_CARD` ou `DEFAULT` (padrão). Controla como o cartão é armazenado para reuso.

Responses

200Cartão tokenizado com sucesso

cardTokenstringoptional

Token do cartão, para reuso em vendas futuras (`card.cardToken`)

slugTokenstringoptional

Identificador do cartão a usar no fluxo de 3DS e na venda

typestringoptional

`TOKENIZED` ou `STORED`

buyerIdstring · uuidoptional

statusstringoptional

Example: ACTIVE

expirationDatestring · date-timeoptional

createdAtstring · date-timeoptional

cardobjectoptional

holderNamestringoptional

Nome do titular impresso no cartão

first6digitsstringoptional

6 primeiros dígitos do cartão (BIN)

last4digitsstringoptional

4 últimos dígitos do cartão

expirationMonthstringoptional

Mês de expiração (MM)

expirationYearstringoptional

Ano de expiração (YYYY)

400Dados do cartão inválidos

401API Key ausente ou inválida

422Cartão recusado pelo processador de pagamentos

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

200Response example

{
  "cardToken": "string",
  "slugToken": "string",
  "type": "string",
  "buyerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "ACTIVE",
  "expirationDate": "2025-01-15T10:30:00Z",
  "createdAt": "2025-01-15T10:30:00Z",
  "card": {
    "holderName": "string",
    "first6digits": "string",
    "last4digits": "string",
    "expirationMonth": "string",
    "expirationYear": "string"
  }
}