Skip to main content
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
​
cross_sell
array
Lista de add-ons (bundle) da assinatura, se houver

​
Exemplo

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",
  "cross_sell": []
}

​
Erros Comuns

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