> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://scaleup-c34c4386.mintlify.site/api-reference/subscriptions/payment-update-token.md).

## 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

```bash cURL theme={null}
curl -X GET "https://api.chargefy.io/api/v1/payment-updates/tok_abc123xyz"
```

## Resposta de Exemplo

```json theme={null}
{
  "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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.