GET /api/v1/buyers/:email/transactions

Lista todas as transações realizadas por um comprador identificado pelo e-mail

Retorna o histórico de transações de um comprador identificado pelo e-mail. Endpoint público — não requer autenticação. Os dados retornados são sanitizados (sem IDs internos ou dados sensíveis do gateway).

​

Autenticação

Não requer autenticação.

​

Parâmetros de Rota

email · string · required

E-mail do comprador. Deve ser um endereço de e-mail válido

​

Resposta

items · array

Lista de transações do comprador. Retorna array vazio se o comprador não for encontrado.

Show Propriedades de cada transação

status · string

Status da transação (ex: succeeded, failed, pending)

payment_type · string

Tipo de pagamento (ex: credit, pix, boleto)

amount · integer

Valor em centavos

currency · string

Moeda (ex: BRL)

installments · integer

Número de parcelas

subtotal_amount · integer

Subtotal em centavos

tax_amount · integer

Valor de impostos em centavos

discount_amount · integer

Valor de desconto em centavos

refunded_amount · integer

Valor reembolsado em centavos

is_refund · boolean

Indica se é um estorno

card_data · object | null

Dados do cartão (somente brand e últimos 4 dígitos)

confirmed_at · string

Data/hora de confirmação

failed_at · string

Data/hora de falha

created_at · string

Data/hora de criação

product · object

Nome do produto (name)

seller · object | null

Nome do vendedor (name)

​

Exemplo

cURL

curl -X GET "https://api.chargefy.io/api/v1/buyers/[e-mail]/transactions"

​

Resposta de Exemplo

{
  "items": [
    {
      "status": "succeeded",
      "payment_type": "credit",
      "amount": 9900,
      "currency": "BRL",
      "installments": 1,
      "subtotal_amount": 9900,
      "tax_amount": 0,
      "discount_amount": 0,
      "refunded_amount": 0,
      "is_refund": false,
      "card_data": {
        "card_brand": "visa",
        "last4_digits": "4242"
      },
      "confirmed_at": "2026-03-20T10:05:00Z",
      "failed_at": null,
      "created_at": "2026-03-20T10:00:00Z",
      "product": { "name": "Plano Pro" },
      "seller": { "name": "Empresa Exemplo Ltda" }
    }
  ]
}