POST /api/v1/buyers/cards/associate

Associa um cartão tokenizado a um comprador no gateway de pagamentos

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
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

​

Resposta

success · boolean

Indica se a associação foi bem-sucedida

card · object

Dados do cartão associado

Show Propriedades

id · string

ID do cartão no gateway

card_brand · string

Bandeira do cartão (ex: visa, mastercard)

first4_digits · string

Primeiros 4 dígitos do cartão

last4_digits · string

Últimos 4 dígitos do cartão

expiration_month · string

Mês de vencimento (dois dígitos)

expiration_year · string

Ano de vencimento (quatro dígitos)

holder_name · string

Nome do titular impresso no cartão

is_valid · boolean

Indica se o cartão é válido

​

Exemplo

cURL

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"
  }'

​

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
  }
}