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

> Retorna o histórico de transações da assinatura vinculada ao token de atualização

Endpoint público que retorna todas as cobranças realizadas na assinatura, ordenadas da mais recente para a mais antiga. Não inclui linhas de estorno.

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

**items** `array`

Lista de transações, ordenadas da mais recente para a mais antiga. Não inclui estornos

**Campos de cada item**

**id** `string`

ID da transação

**status** `string`

Status da transação: `new`, `pending`, `succeeded`, `failed`, `canceled` e outros

**payment\_type** `string`

Tipo de pagamento: `credit`, `boleto`, `pix`

**amount** `number`

Valor em centavos

**currency** `string`

Moeda (ex: `BRL`)

**installments** `number`

Número de parcelas (se aplicável)

**card\_data** `object`

Dados do cartão utilizado (se aplicável)

**confirmed\_at** `string`

Data de confirmação do pagamento

**created\_at** `string`

Data de criação da transação

## Exemplo

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

## Resposta de Exemplo

```json theme={null}
{
  "items": [
    {
      "id": "txn_abc123",
      "status": "succeeded",
      "payment_type": "credit",
      "amount": 4990,
      "currency": "BRL",
      "installments": 1,
      "card_data": {
        "card_brand": "Visa",
        "last4_digits": "4242"
      },
      "confirmed_at": "2026-03-01T10:05:00Z",
      "created_at": "2026-03-01T10:00:00Z"
    }
  ]
}
```

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