Listar cobranças

Lista charges em ordem decrescente de criação. Charges são somente leitura: para cobrar alguém, crie e confirme um payment_intent.

Filtros

string

Filtra por payment intent (pi_*).

string

Filtra por invoice (inv_*).

string

Filtra por customer (cus_*).

string

Filtra por payment method (pm_*).

string

Filtra por status.

Valor	Descrição
`pending`	Aguardando confirmação do pagamento.
`processing`	Pagamento em processamento.
`succeeded`	Pagamento confirmado.
`failed`	A tentativa de pagamento falhou.
`canceled`	A cobrança foi cancelada.

string

Retorna cobranças criadas nesta data/hora ou depois, em ISO 8601.

string

Retorna cobranças criadas depois desta data/hora, em ISO 8601.

string

Retorna cobranças criadas nesta data/hora ou antes, em ISO 8601.

string

Retorna cobranças criadas antes desta data/hora, em ISO 8601.

string

Filtra por credit_card, pix ou boleto.

string

Filtra por visa, mastercard, amex ou elo.

integer

Filtra pela quantidade de parcelas, de 1 a 12.

string

Filtra pela categoria Chargefy: issuer_declined, invalid, blocked ou processing_error.

string

Filtra pelo código Chargefy estável, como insufficient_funds.

string

Filtra pelo código bruto da rede. Combine com card_brand para evitar interpretações ambíguas.

integer

Quantidade de itens, de 1 a 100.

string

Cursor para a próxima página.

string

Cursor para a página anterior.

curl -X GET "https://api.chargefy.io/v1/charges?payment_intent=pi_TTGmhjwGXjVJDHdp&limit=10" \
  -H "Authorization: Bearer {{API_KEY}}"

200

{
  "object": "list",
  "data": [
    {
      "id": "ch_LXFDC2J4EMrczpvU",
      "object": "charge",
      "amount": 9990,
      "amount_captured": 9990,
      "amount_refunded": 0,
      "billing_details": {},
      "captured": true,
      "created_at": "2026-05-16T18:35:00Z",
      "currency": "brl",
      "customer": "cus_EwP4DuLMc8GfeYfL",
      "description": null,
      "disputed": false,
      "invoice": "inv_sADQktBN8nvu4XQJ",
      "livemode": true,
      "metadata": {},
      "paid": true,
      "payment_error": null,
      "payment_intent": "pi_TTGmhjwGXjVJDHdp",
      "payment_method": "pm_Jf5ds8hkbMZDvNGB",
      "payment_method_details": {
        "card": {
          "amount_authorized": 9990,
          "authorization_code": "123456",
          "brand": "visa",
          "checks": {
            "address_line1_check": "unchecked",
            "address_postal_code_check": "unchecked",
            "cvc_check": "pass"
          },
          "country": null,
          "exp_month": 12,
          "exp_year": 2030,
          "funding": null,
          "installments": 1,
          "last4": "4242",
          "network": null
        },
        "type": "credit_card"
      },
      "receipt_url": null,
      "refunded": false,
      "refunds": {
        "object": "list",
        "data": [],
        "has_more": false,
        "url": "/v1/refunds?charge=ch_LXFDC2J4EMrczpvU"
      },
      "status": "succeeded",
      "updated_at": "2026-05-16T18:35:00Z"
    }
  ],
  "has_more": false,
  "url": "/v1/charges"
}

Erros comuns

400

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid value for card_brand.",
    "param": "card_brand",
    "type": "invalid_request_error"
  }
}

401

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API key provided.",
    "type": "authentication_error"
  }
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Listar cobranças

Filtros

Erros comuns

​Filtros

​Erros comuns

Filtros

Erros comuns