Cria um token com validade de 48 horas e retorna uma URL que pode ser compartilhada com o cliente para que ele atualize o cartão de crédito vinculado à assinatura.
Autenticação
Requer um token de acesso válido (CHARGEFY_ACCESS_TOKEN) no header Authorization. Escopos necessários: web:write ou subscriptions:write.
Parâmetros de Path
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
id | string | Sim | ID da assinatura |
Somente assinaturas com status: active, trialing, unpaid ou past_due podem gerar tokens de atualização de pagamento.
Campos da Resposta
| Campo | Tipo | Descrição |
|---|
url | string | URL com o token de atualização, válida por 48 horas |
expires_at | datetime | Data e hora de expiração do token |
Exemplo de Requisição
curl -X POST "https://api.chargefy.io/api/v1/subscriptions/sub_1a2b3c4d/payment-update-token" \
-H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"
Exemplo de Resposta
{
"url": "https://app.chargefy.com.br/update-payment/tok_eyJzdWIiOiJzdWJfMWEyYjNjNGQifQ",
"expires_at": "2026-03-22T10:00:00Z"
}
