InstantTransfer
  1. Balance
InstantTransfer
  • PayStar API Documentation
    • Introduction
    • Authorization Bearer
    • Sandbox
    • Callbacks
    • Glossary
    • Dictionarys
      • Currencys
      • Telecom operators
      • Bank names
    • Deposit direct (Merch)
      • Create | Deposit order
      • Check status | Deposit order
    • Deposit reverse (Gateway)
      • Create | Reverse deposit order
      • Check status | Deposit order
    • Withdrawal direct (Merch)
      • Create | Withdrawal order
      • Check status | Withdrawal order
    • Balance
      • GET Merchant balance
        GET
  • Armax API
    • POST Armax Order
      POST
  • Butler API Bridge
    • Authorization Bearer
    • Withdrawal direct | PDO API Bridge
      • Check status | Withdrawal order
      • Create | Withdrawal Order
    • PSP Deposit Order
      • PSP Deposit Order
      • PSP Deposit Order status
    • Merch Deposit Order
      • Merch Deposit Order
      • Merch Deposit Order status
  • CoreFy API
    • Withdrawal Order
      POST
    • Payment Order
      POST
  • PayNetEasy API Bridg
    • Introduсtion
    • Autorization
    • Glossary
    • POST order
      POST
    • POST Status order
      POST
  1. Balance

GET Merchant balance

Developing
GET
/api/v1/balance/merchant
You can use this CURL to create a Withdrawal order.
curl --request GET \
--url https://baseurl.com/api/v1/balance/merchant?currency=USD' \
--header 'Authorization: Bearer Your Token' \
--header 'accept: text/plain' \
The provided JSON object contains key financial metrics for a partner's account. Here's the translated version with explanations:
{
  "currency": "USD", // Currency of the balance, mandatory QUERY parameter in the request
  "merchantBalance": 1000.00, // Current balance of the merchant
  "merchantOverdraft": 1500.00, // Permissible overdraft amount
  "pipelineBalance": 500.00, // Current pipeline balance (Authorization points)
  "pipelineProcessingOrdersDeposit": 0.00, // Current amount of deposits in non-final statuses (Created, Processing)
  "pipelineProcessingOrdersWithdrawals": 100.00 // Current amount of withdrawals in non-final statuses (Created, Processing)
}
Explanation of Each Field:
currency: Specifies the currency of the balance, in this case, Dollar (USD). The dictionary of available currencies can be found here: https://apidoc.paystar.uk/currencys
merchantBalance: Indicates the current balance available to the partner, which is 1,000.00 USD.
merchantOverdraft: Denotes the permissible overdraft amount, allowing the partner to overdraw up to 1,500.00 USD.
pipelineBalance: Reflects the current balance within the pipeline, amounting to 500.00 USD.
pipelineProcessingOrdersDeposit: Represents the total amount of deposits that are in non-final statuses such as 'Created' or 'Processing'. Here, it is 0.00 USD, indicating no pending deposits.
pipelineProcessingOrdersWithdrawals: Shows the total amount of withdrawals that are in non-final statuses. The value is 100.00 USD, indicating withdrawals that have been initiated but not yet completed.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/v1/balance/merchant' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Success
application/json
Body

Example
{
    "currency": "USD",
    "merchantBalance": 1000,
    "merchantOverdraft": 1500,
    "pipelineBalance": 500,
    "pipelineProcessingOrdersDeposit": 0,
    "pipelineProcessingOrdersWithdrawals": 100
}
Modified at 2024-12-12 13:18:26
Previous
Check status | Withdrawal order
Next
POST Armax Order
Built with