GET /api/v1/payment-updates/:token

Retorna as informações da assinatura vinculada a um token de atualização de pagamento

Endpoint público (sem autenticação) que retorna os dados necessários para renderizar a página de atualização de cartão. O token é a prova de autorização — gerado pelo endpoint Gerar Link de Atualização de Cartão.

​

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

​

Resposta

subscription_id · string

ID da assinatura associada ao token

product_name · string

Nome do produto da assinatura

amount · number

Valor da assinatura em centavos

currency · string

Moeda da assinatura (ex: brl)

recurring_interval · string

Intervalo de recorrência: month ou year

buyer_id · string

ID do comprador no gateway (se disponível). Usado para listar cartões salvos

​

Exemplo

cURL

curl -X GET "https://api.chargefy.io/api/v1/payment-updates/tok_abc123xyz"

​

Resposta de Exemplo

{
  "subscription_id": "sub_1a2b3c4d",
  "product_name": "Plano Pro",
  "amount": 4990,
  "currency": "brl",
  "recurring_interval": "month",
  "buyer_id": "gw_buyer_xyz"
}

​

Erros Comuns

Código	Descrição
404	Token inválido ou expirado