Skip to main content
Associa um token de cartão (gerado pelo frontend com o SDK do gateway) a um comprador existente no gateway. Após a associação, o ID do cartão é salvo localmente para uso em cobranças recorrentes. Fluxo PCI-compliant:
  1. O frontend tokeniza o cartão diretamente no gateway usando a publishable_key (ver Configuração do gateway)
  2. O frontend envia o token_id + buyer_id para este endpoint
  3. O backend associa o cartão ao comprador no gateway e salva o ID localmente

​
Autenticação

Não requer autenticação.

​
Corpo da Requisição

​
buyer_id
string
required
ID do comprador no gateway (obtido em Criar Comprador ou Buscar Comprador)
​
token_id
string
required
ID do token do cartão gerado pelo frontend no fluxo de tokenização do gateway
​
checkout_id
string
ID da sessão de checkout (opcional, usado para analytics do funil)

​
Resposta

​
success
boolean
Indica se a associação foi bem-sucedida
​
card
object
Dados do cartão associado

​
Exemplo

curl -X POST "https://api.chargefy.io/api/v1/buyers/cards/associate" \
  -H "Content-Type: application/json" \
  -d '{
    "buyer_id": "gw_buyer_abc123",
    "token_id": "tok_xxxxxxxxxxxxxxxxx",
    "checkout_id": "chk_1a2b3c4d5e6f"
  }'

​
Resposta de Exemplo

{
  "success": true,
  "card": {
    "id": "card_xyz789abc",
    "card_brand": "visa",
    "first4_digits": "4111",
    "last4_digits": "1111",
    "expiration_month": "12",
    "expiration_year": "2028",
    "holder_name": "JOAO SILVA",
    "is_valid": true
  }
}