Selar um cartão

POST

/api/partner/v1/card-tokens

Recebe o cartão em claro e devolve um token selado, de uso único,
válido por 15 minutos e vinculado à sua conta.

Este é o único endpoint da API que aceita o número do cartão. Nada é
persistido: o cartão é cifrado e devolvido no token.

Validações aplicadas

number: 13 a 19 dígitos e dígito verificador de Luhn.

expiry_month + expiry_year: validade não pode estar no passado.

cvv: 3 ou 4 dígitos.

brand e last4 na resposta são derivados do número pelo servidor —
não os envie, e não confie em bandeira calculada no cliente.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢201

application/json

Token selado emitido.

Bodyapplication/json

🟠422

🟠401Unauthorized

🟠403CreditCardDisabled

🟠429TooManyRequests

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/partner/v1/card-tokens' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "card": {
        "number": "5149452665242701",
        "holder_name": "MARIA DA SILVA",
        "expiry_month": "06",
        "expiry_year": "2031",
        "cvv": "123"
    }
}'

Response Example

201 - ok

{
    "data": {
        "token": "card_token.yV5IhEG7gIUgHyKnUTE2Uozams0JpjCpbc5it3NG-nw…",
        "brand": "mastercard",
        "last4": "2701",
        "expires_at": "2026-08-11T14:47:53.000000Z"
    }
}

Modificado em 2026-08-11 13:15:15

Página anterior

Consulta dados do Parceiro

Próxima página

Cobrar no cartão

Selar um cartão

Validações aplicadas#

Requisição

Respostas

Validações aplicadas