Criar token de cartão

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_iduuidrequired

Id do cliente

Body Params

numberstringrequired

Número do cartão (13 a 19 dígitos)

holder_namestringrequired

Nome do portador como impresso no cartão (máx. 80 caracteres)

holder_documentstringrequired

CPF ou CNPJ do portador (máx. 14 caracteres)

exp_monthintegerrequired

Mês de validade (1 a 12)

exp_yearintegerrequired

Ano de validade (ex: 2030)

cvvstringrequired

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

brandstringoptional

Bandeira: elo, mastercard, visa, amex, hipercard, diners ou discover

descriptionstringoptional

Descrição sobre o cartão

tokenstringoptional

Token gerado por SDK (substitui os dados do cartão se já tokenizado)

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

Response

Choose an example:

application/json

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