PayStar API Documentation
    • Introduction
    • Glossary
    • Authorization key
    • Sandbox
    • Additional fields
    • Currencies
    • Bank names
    • Callbacks
    • Telecom operators
    • Payment history
    • Error descriptions
    • Tech FAQ
    • Events
    • Balance H2H
      GET
    • Deposit H2H - ECOM (with PCI) / P2P / Online
      POST
    • Deposit H2H - ECOM by Card token (without PCI)
      POST
    • Deposit H2C - ECOM (without PCI)
      POST
    • Deposit status H2H - PayStar ID
      GET
    • Deposit status H2H - Merch ID
      GET
    • Payout H2H
      POST
    • Payout status H2H - PayStar ID
      GET
    • Payout status H2H - Merch ID
      GET

      Balance H2H

      GET
      https://api.PayStar.uk/api/v1/balance/merchant
      Maintainer:Not configured
      INFO
      Current method is used to get the balance, which returns both the overall merchant balance and the balance of the specific endpoint (authorization key) used for the request.
      Please note that many limits and restrictions are tied specifically to the endpoint balance. If you have multiple authorization keys, we recommend checking the balance for each key individually.
      You can use this CURL to get maerchnt balance
      curl --request GET \
      --url https://api.PayStar.uk/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
        "merchantBalance": 10000.00, // Current balance of the merchant
        "merchantOverdraft": 1000.00, // Permissible overdraft amount
        "pipelineBalance": 5000.00, // Current pipeline balance 
        "pipelineProcessingOrdersDeposit": 0.00, // Current amount of deposits in non-final statuses (Created, Processing)
        "pipelineProcessingOrdersWithdrawals": 4000.00 // Current amount of withdrawals in non-final statuses (Created, Processing)
        "pipelineAvailableBalance": 1000.0 // Available for usw pipeline balance 
      }
      Explanation of Each Field:
      Currency: Specifies the currency of the balance, in this case, Dollar (USD).
      MerchantBalance: Indicates the current balance available to the partner, which is 10,000.00 USD.
      MerchantOverdraft: Denotes the permissible overdraft amount, allowing the partner to overdraw up to 1,000.00 USD.
      PipelineBalance: Reflects the current balance within the pipeline, amounting to 5,000.00 USD.
      pipelineAvailableBalance: Reflects the current balance within the pipeline, amounting to 1,000.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 payouts that are in non-final statuses. The value is 4,000.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

      Responses

      🟒200Success
      application/json
      Bodyapplication/json

      🟠400Bad request
      🟠401Unauthorized
      🟠403Forbidden endpoint
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location 'https://api.PayStar.uk/api/v1/balance/merchant?currency=USD' \
      --header 'Authorization: Bearer <token>'
      Response Response Example
      {
          "currency": "RUB",
          "merchantBalance": 10000,
          "merchantOverdraft": 1000,
          "pipelineBalance": 5000,
          "pipelineAvailableBalance": 1000,
          "pipelineProcessingOrdersDeposit": 0,
          "pipelineProcessingOrdersWithdrawals": 4000
      }
      Previous
      Events
      Next
      Deposit H2H - ECOM (with PCI) / P2P / Online
      Built with