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

Show 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

cURL

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

​

Resposta de Exemplo

{
  "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