Skip to main content
curl -X POST "https://api.chargefy.io/v1/tokens" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "4242424242424242",
    "exp_month": 12,
    "exp_year": 2030,
    "cvc": "123",
    "name": "NOME DO TITULAR"
  }'

{
  "id": "tok_123",
  "object": "token",
  "card": {
    "brand": "visa",
    "exp_month": 12,
    "exp_year": 2030,
    "last4": "4242"
  },
  "created_at": "2026-05-16T14:09:27Z",
  "livemode": true
}
Troca os dados de um cartão por um token opaco de uso único. O número (PAN) e o CVC são trocados pelo token e não são retornados nem armazenados.
Normalmente você não chama este endpoint diretamente. O Chargefy.js o chama no navegador do comprador, para o número do cartão nunca tocar o seu servidor — é o caminho recomendado e mantém o seu PCI baixo. Chame POST /v1/tokens direto apenas se você coleta o cartão em um ambiente próprio já certificado para tratar dados de cartão.
Por ser usado a partir do navegador do comprador, este endpoint não exige chave de API.
​
number
string
required
Número do cartão. Espaços e traços são ignorados.
​
exp_month
number
required
Mês de validade (1–12).
​
exp_year
number
required
Ano de validade. Aceita quatro dígitos (2030) ou dois (30).
​
cvc
string
required
Código de segurança (3 ou 4 dígitos).
​
name
string
required
Nome do titular impresso no cartão.

​
O que fazer com o token

O id retornado (tok_*) é de uso único. Envie-o ao seu backend e use-o uma vez como token_id ao confirmar um setup intent — isso salva o cartão como um payment_method (pm_*) reutilizável. Depois de consumido, o token morre; para uma nova tentativa, gere outro.

​
Erros

SituaçãoResposta
Número, validade, CVC ou nome inválidos402 card_error (invalid_number, invalid_expiry_month, invalid_expiry_year, invalid_cvc, invalid_name) com param.
Cartão recusado na tokenização402 card_error (tokenization_failed / invalid_card).
Corpo da requisição não é JSON válido400 invalid_request_error (invalid_request).
Tokenização temporariamente indisponível503 api_error (tokenization_unavailable).
curl -X POST "https://api.chargefy.io/v1/tokens" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "4242424242424242",
    "exp_month": 12,
    "exp_year": 2030,
    "cvc": "123",
    "name": "NOME DO TITULAR"
  }'

{
  "id": "tok_123",
  "object": "token",
  "card": {
    "brand": "visa",
    "exp_month": 12,
    "exp_year": 2030,
    "last4": "4242"
  },
  "created_at": "2026-05-16T14:09:27Z",
  "livemode": true
}