Bynet
  1. Balance
Bynet
  • 🚀 Introdução à API
  • 📦 Criar Pedido
  • My company
    • Get all data
      GET
    • Update
      PUT
    • Update documents
      PUT
    • Get by ID
      GET
    • Update other info
      PUT
  • Products
    • Create
      POST
    • Find All
      GET
    • Find by ID
      GET
    • Update
      PUT
    • Delete
      DELETE
    • Update Status
      PUT
  • Bank
    • Create
      POST
    • Find all
      GET
    • Find by ID
      GET
    • Find pre bank
      GET
  • Transactions
    • Find All
      GET
    • Create
      POST
    • Find by ID
      GET
    • Update delivery status
      PUT
    • Export Excel
      POST
    • Summary all
      GET
    • Fee
      POST
    • Summary by ID
      GET
  • Checkout
    • Layouts
      • Create Layout
      • Find
      • Update settings
      • Update status
      • Find by ID
    • Find info
    • Create Order
    • Find info order
    • Find payment methods by ID
    • Create payment
    • Find payment methods
  • Transfers
    • Create
    • Update
    • Find all
    • Find by ID
    • summary
  • Cashout
    • Create
    • Find all
    • Find by ID
  • Customers
    • Find all
    • Find by ID
  • Balance
    • Find
      GET
    • Summary
      GET
    • Find finalcial reserve
      GET
  • Webhook
    • ⚙️ Webhook: Formato de Postback
    • Create
    • Find all
    • Find by ID
    • Update
    • Delete
  1. Balance

Find

GET
/api/user/balance-history
Este endpoint permite consultar o histórico de saldo do usuário autenticado. Ele retorna os registros das movimentações de saldo associadas ao usuário.

✅ Requisitos da Requisição#

Método HTTP: GET
Endpoint: /api/user/balance-history
Content-Type: application/json
Autenticação: api_token

🧠 Header da requisição#

CampoTipoObrigatórioDescrição
x-api-keystringSimToken de autenticação API Key
User-AgentAtivoB2B/1.0Sim

Request

Header Params

Responses

🟢200Success
application/json
Body

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/user/balance-history' \
--header 'x-api-key: {Token}' \
--header 'User-Agent: AtivoB2B/1.0'
Response Response Example
200 - Success
{
  "message": "Histórico do saldo encontrado com sucesso.",
  "data": {
    "data": [
      {
        "id": "XXXX",
        "inflows": 0,
        "outflows": 1000,
        "total": 1000,
        "status": "REFUNDED",
        "description": null,
        "transactionId": "XXXX",
        "transactionFinancialReserveId": null,
        "anticipationId": null,
        "gatewayId": "XXXX",
        "sellerId": "XXXX",
        "createdAt": "2025-04-16T15:37:02.331Z"
      },
      {
        "id": "XXXX",
        "inflows": 100000,
        "outflows": 28000,
        "total": 72000,
        "status": "ANTICIPATION",
        "description": "Antecipação de recebíveis",
        "transactionId": null,
        "transactionFinancialReserveId": null,
        "anticipationId": "XXXX",
        "gatewayId": "XXXX",
        "sellerId": "XXXX",
        "createdAt": "2025-04-16T14:35:51.567Z"
      }
    ],
    "pages": 5,
    "page": 1,
    "limit": 10,
    "total": 48
  },
  "status": 200,
  "error": null
}
Modified at 2025-07-23 19:02:40
Previous
Find by ID
Next
Summary
Built with