Skip to main content
Endpoint público que recebe o novo card_id (tokenizado no gateway) e atualiza o cartão vinculado à assinatura de recorrência no provedor de pagamentos. Também persiste os dados do cartão na base de dados da assinatura.

​
Autenticação

Nenhuma. O token na URL é a prova de autorização.

​
Parâmetros de Path

​
token
string
required
Token único gerado pelo endpoint POST /api/v1/subscriptions/:id/payment-update-token. Válido por 48 horas

​
Corpo da Requisição

​
card_id
string
required
ID do cartão tokenizado no gateway. O cartão deve pertencer ao comprador vinculado à assinatura

​
Resposta

​
success
boolean
true quando o cartão for atualizado com sucesso na assinatura no gateway

​
Exemplo

curl -X POST "https://api.chargefy.io/api/v1/payment-updates/tok_abc123xyz/confirm" \
  -H "Content-Type: application/json" \
  -d '{"card_id": "card_gw_789"}'

​
Resposta de Exemplo

{
  "success": true
}

​
Erros Comuns

CódigoDescrição
400card_id não informado
404Token inválido ou expirado
422Assinatura sem recorrência no gateway (zoop_subscription_id ausente)
500Erro ao atualizar o cartão no provedor de pagamentos