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

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

```bash cURL theme={null}
curl -X GET "https://api.chargefy.io/api/v1/buyers/joao@exemplo.com/transactions"
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';

const chargefy = new Chargefy({
  accessToken: process.env.CHARGEFY_ACCESS_TOKEN,
});

const result = await chargefy.buyers.getTransactions('joao@exemplo.com');
```

## Resposta de Exemplo

```json theme={null}
{
  "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" }
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.