Criar token de cartão

POST/customers/{customer_id}/card-token

Atualizado em 21 de março de 2025 · 3 min de leitura

Tokenize um cartão de crédito vinculando-o a um cliente existente.

Cria um token de cartão vinculado a um cliente. O token pode ser utilizado em cobranças futuras e assinaturas sem necessidade de reinserir os dados do cartão.

POSThttps://{apiUrl}/customers/{customer_id}/card-token

URL base da API

Token de autenticação

Path Params

customer_idstringrequired

ID do cliente

Body Params

card_numberstringrequired

Número completo do cartão de crédito

holder_namestringrequired

Nome do titular como impresso no cartão

exp_monthstringrequired

Mês de expiração (ex: 12)

exp_yearstringrequired

Ano de expiração (ex: 2030)

cvvstringrequired

Código de segurança (3 ou 4 dígitos)

documentstringoptional

CPF ou CNPJ do titular

document_typestringoptional

Tipo do documento (CPF ou CNPJ)

curl --request POST \
  --url "https://{apiUrl}/customers/{customer_id}/card-token" \
  --header "Content-Type: application/json" 
  --data '{}'

Response

Choose an example:

application/json

Parâmetros

Path

Parâmetro	Tipo	Obrigatório	Descrição
`customer_id`	string	Sim	ID do cliente

Headers

Parâmetro	Tipo	Obrigatório	Descrição
`Authorization`	string	Sim	Chave privada no formato `Bearer {token}`

Body

Parâmetro	Tipo	Obrigatório	Descrição
`card_number`	string	Sim	Número completo do cartão de crédito
`holder_name`	string	Sim	Nome do titular como impresso no cartão
`exp_month`	string	Sim	Mês de expiração (ex: `12`)
`exp_year`	string	Sim	Ano de expiração (ex: `2030`)
`cvv`	string	Sim	Código de segurança (3 ou 4 dígitos)

Exemplo de requisição

bash

curl --request POST \
  --url https://{apiUrl}/customers/{customer_id}/card-token \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "card_number": "4111111111111111",
    "holder_name": "Joao da Silva",
    "exp_month": "12",
    "exp_year": "2030",
    "cvv": "123"
  }'

Responses

Esta página foi útil?