Listar transações

GET/v1/transactions

Lista cobranças e saques da conta, ordenados por data de criação (mais recentes primeiro).

Parâmetros (query)

Nome	Tipo	Descrição
`type`	string	Filtra por tipo: `pix_in` (cobranças) ou `withdrawal` (saques). Sem o parâmetro, retorna ambos.
`limit`	inteiro	Quantidade. Default `50`, máximo `100`.

Não há paginação por cursor hoje. Para datasets maiores, considere consultar transações específicas via GET /v1/transactions/:id ou processar em janelas pelo seu próprio histórico de transactionId.

Resposta `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	Descrição
`transactionId`	ID da transação.
`type`	`"pix_in"` ou `"withdrawal"`.
`amountCents`, `feeCents`, `netCents`	Valores em centavos.
`status`	Veja Status.
`externalRef`	Identificador que você forneceu na criação.
`pixPayload`	Copia-e-cola PIX (apenas em `pix_in`).
`expiresAt`	Unix timestamp em segundos (cobranças).
`paidAt`, `createdAt`, `updatedAt`	Unix timestamp em milissegundos.
`endToEndId`	(opcional) E2E ID padrão BACEN, presente em transações liquidadas (`paid`/`refunded`).
`payer`	(opcional) Dados do pagador em `pix_in` que recebeu pagamento — `{ name, document, documentType, bankAccount: { ispb, branch, account } }`. Veja Eventos.
`beneficiary`	(opcional) Dados do destinatário em `withdrawal` que liquidou — mesma estrutura de `payer`.
`refundEndToEndId`	(opcional) E2E ID do PIX de devolução, em saques devolvidos.

Atenção: expiresAt está em segundos; paidAt, createdAt e updatedAt estão em milissegundos.

Os campos endToEndId, payer, beneficiary e refundEndToEndId são opcionais — omitidos do JSON quando a transação ainda não foi liquidada (pending, processing, failed, cancelled, expired).

Exemplos

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);

Cadastrar destinatário autorizado Consultar transação

Listar transações

Parâmetros (query)

Resposta 200 OK

Exemplos

Resposta `200 OK`