Listar transacciones

GET/v1/transactions

Lista cobros y retiros de la cuenta, ordenados por fecha de creación (más recientes primero).

Parámetros de consulta

Nombre	Tipo	Descripción
`type`	string	Filtra por tipo: `pix_in` (cobros) o `withdrawal` (retiros). Sin el parámetro, devuelve ambos.
`limit`	entero	Cantidad. Por defecto `50`, máximo `100`.

Hoy no hay paginación por cursor. Para datasets más grandes, consulta transacciones específicas vía GET /v1/transactions/:id o procésalas por ventanas usando tu propio historial de transactionId.

Respuesta `200 OK`

{
  "transactions": [
    {
      "transactionId": "Q4t9aV...",
      "type": "pix_in",
      "amountCents": 1000,
      "feeCents": 10,
      "netCents": 990,
      "status": "paid",
      "externalRef": "pedido-123",
      "pixPayload": "00020126580014BR.GOV.BCB.PIX...",
      "expiresAt": 1715000000,
      "paidAt": 1714999100000,
      "createdAt": 1714998000000,
      "updatedAt": 1714999100000
    }
  ],
  "count": 1
}

Campo	Descripción
`transactionId`	ID de la transacción.
`type`	`"pix_in"` o `"withdrawal"`.
`amountCents`, `feeCents`, `netCents`	Valores en centavos.
`status`	Ver Estados.
`externalRef`	Identificador que enviaste en la creación.
`pixPayload`	Copiar-y-pegar PIX (solo en `pix_in`).
`expiresAt`	Timestamp Unix en segundos (cobros).
`paidAt`, `createdAt`, `updatedAt`	Timestamp Unix en milisegundos.
`endToEndId`	(opcional) E2E ID estándar BACEN, presente en transacciones liquidadas (`paid`/`refunded`).
`payer`	(opcional) Datos del pagador en `pix_in` que recibió pago — `{ name, document, documentType, bankAccount: { ispb, branch, account } }`. Ver Eventos.
`beneficiary`	(opcional) Datos del destinatario en `withdrawal` liquidado — misma estructura de `payer`.
`refundEndToEndId`	(opcional) E2E ID del PIX de devolución, en retiros devueltos.

Atención: expiresAt está en segundos; paidAt, createdAt y updatedAt están en milisegundos.

Los campos endToEndId, payer, beneficiary y refundEndToEndId son opcionales — omitidos del JSON cuando la transacción aún no se liquidó (pending, processing, failed, cancelled, expired).

Ejemplos

curl "https://api.internationalfinance.com.br/v1/transactions?type=pix_in&limit=20" \
  -H "Authorization: Bearer $INFI_API_KEY"

const params = new URLSearchParams({ type: 'pix_in', limit: '20' })
const res = await fetch(`https://api.internationalfinance.com.br/v1/transactions?${params}`, {
  headers: { Authorization: `Bearer ${process.env.INFI_API_KEY}` },
})
const { transactions } = await res.json()

import os, requests
 
res = requests.get(
    "https://api.internationalfinance.com.br/v1/transactions",
    headers={"Authorization": f"Bearer {os.environ['INFI_API_KEY']}"},
    params={"type": "pix_in", "limit": 20},
)
data = res.json()

<?php
$client = new GuzzleHttp\Client();
$res = $client->get('https://api.internationalfinance.com.br/v1/transactions', [
  'headers' => ['Authorization' => 'Bearer ' . getenv('INFI_API_KEY')],
  'query'   => ['type' => 'pix_in', 'limit' => 20],
]);
$data = json_decode($res->getBody(), true);

Listar destinatarios autorizados Consultar transacción

Listar transacciones

Parámetros de consulta

Respuesta 200 OK

Ejemplos

Respuesta `200 OK`