POST /api/v1/payment-updates/:token/confirm

Atualiza o cartão de pagamento da assinatura usando um token de atualização

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

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ódigo	Descrição
400	card_id não informado
404	Token inválido ou expirado
422	Assinatura sem recorrência no gateway (zoop_subscription_id ausente)
500	Erro ao atualizar o cartão no provedor de pagamentos