Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt

Use this file to discover all available pages before exploring further.

Retorna todas as transações (cobranças) associadas a uma assinatura, ordenadas da mais recente para a mais antiga. Não inclui linhas de estorno.

​
Autenticação

Requer um token de acesso válido (CHARGEFY_ACCESS_TOKEN) no header Authorization. Escopos necessários: web:read, web:write ou subscriptions:read.

​
Parâmetros de Path

ParâmetroTipoObrigatórioDescrição
idstringSimID da assinatura

​
Campos da Resposta

CampoTipoDescrição
itemsarrayLista de transações
items[].idstringID da transação
items[].statusstringStatus da transação: new, pending, succeeded, failed, canceled, pre_authorized, reversed, refunded, partial_refunded, dispute, charged_back
items[].payment_typestringTipo de pagamento: credit, boleto, pix
items[].amountnumberValor em centavos
items[].currencystringMoeda (BRL)
items[].installmentsnumber | nullNúmero de parcelas
items[].card_dataobject | nullDados do cartão utilizado
items[].billing_reasonstring | nullMotivo da cobrança
items[].descriptionstring | nullDescrição da transação
items[].confirmed_atdatetime | nullData de confirmação do pagamento
items[].created_atdatetimeData de criação

​
Exemplo de Requisição

curl -X GET "https://api.chargefy.io/api/v1/subscriptions/sub_1a2b3c4d/transactions" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"

​
Exemplo de Resposta

{
  "items": [
    {
      "id": "txn_abc123",
      "status": "succeeded",
      "payment_type": "credit",
      "amount": 4990,
      "currency": "BRL",
      "installments": 1,
      "card_data": {
        "brand": "Visa",
        "last4": "4242"
      },
      "billing_reason": "subscription_cycle",
      "description": null,
      "confirmed_at": "2026-03-01T10:05:00Z",
      "created_at": "2026-03-01T10:00:00Z"
    }
  ]
}