Listar Transações

Requer autenticação

POST/v2/account/transactions/list

Consulta o extrato completo da conta. Filtre por moeda, status, tipo de operação, data ou IDs específicos.

Parâmetros

pagenumber

Número da página (1+). Padrão: 1.

page_sizenumber

Registros por página (1–100). Padrão: 50.

statusstring

Filtrar por status: pending, confirmed, cancelled, failed. null = todos.

typestring

Filtrar por tipo: cashin, cashout. null = todos.

currencystring

Filtrar por moeda: BRL, MXN, USDT, BTC, etc. null = todas.

sourcestring

Filtrar por origem: cashin, cashout, conversion, internal_transfer, wallet_deposit. null = todas.

from_datestring

Data inicial YYYY-MM-DD.

to_datestring

Data final YYYY-MM-DD.

transaction_idstring

Buscar por ID de transação específico.

external_idstring

Buscar por ID externo do seu sistema.

Rate limit

300 reqs/min.

Erros

Código	HTTP	Descrição
`INVALID_PAYLOAD`	400	Payload malformado
`INVALID_FORMAT`	422	Formato de data ou campo inválido
`INVALID_VALUE`	422	Valor de filtro não aceito (ex: `status` inexistente)
`UNAUTHORIZED`	401	Token inválido ou expirado

cURL

PHP

JavaScript

Python

curl -X POST https://api.bspay.co/v2/account/transactions/list \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "page_size": 20,
    "currency": "BRL",
    "type": "cashout",
    "from_date": "2026-04-01",
    "to_date": "2026-04-30"
  }'

Resposta 200

{
  "success": true,
  "data": {
    "items": [
      {
        "source": "cashin",
        "end_to_end_id": null,
        "pix_code": "00020101021226640014br.gov.bcb.pix...",
        "confirmed_at": null,
        "refunded_at": null,
        "status": "pending",
        "old_balance": "8446.75",
        "new_balance": null,
        "transaction_id": "bc29f8989cc0ab75a9c4a691e716bbf4",
        "external_id": "order_001",
        "direction": "credit",
        "amount": "10.00",
        "fee_amount": "0.30",
        "description": "Teste integração cashin",
        "created_at": "2026-04-04 10:20:53",
        "updated_at": null,
        "currency": "BRL",
        "currency_type": "fiat",
        "hash": null,
        "payer": {
          "name": null,
          "document": null
        },
        "receiver": {
          "name": "Acme Pagamentos LTDA",
          "document": "00.000.000/0001-00"
        },
        "generated": {
          "name": "João da Silva",
          "document": "11370243480",
          "email": ""
        },
        "credential": {
          "client_id": "merchant_demo_8d6efc0497b25af2",
          "name": "minha-integracao"
        }
      },
      {
        "source": "conversion",
        "status": "confirmed",
        "old_balance": "0",
        "new_balance": "0",
        "transaction_id": "09ff0e84a608427259c609af2be3434b",
        "external_id": "conv_brl_usdt_001",
        "direction": "swap",
        "fee_amount": "0.00",
        "description": "",
        "created_at": "2026-04-04 10:21:15",
        "updated_at": "2026-04-04 10:21:15",
        "conversion": {
          "from": {
            "amount": "1.00",
            "currency": "BRL",
            "type": "fiat",
            "old_balance": "8446.44",
            "new_balance": "8445.44"
          },
          "to": {
            "amount": "0.189973",
            "currency": "USDT",
            "type": "crypto",
            "old_balance": "101639.404026",
            "new_balance": "101639.593999"
          }
        }
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "count": 2,
      "total": 42,
      "total_pages": 3,
      "has_next": true,
      "has_prev": false
    },
    "summary": {
      "total_transactions": 42,
      "total_in": "10.00",
      "total_out": "0.01",
      "total_fees": "0.60"
    }
  },
  "request_id": "39316c1fcf4333e9f4726180",
  "timestamp": "2026-04-04T13:20:30Z"
}

AnteriorCarteira FixaPróximoPerfil