Get information on Merchant Balance

You can get information about your merchant balance by using a few actions based on GET HTTP request. You can specify various filters as parameters in the query string in order to get a customized list of your available balances per MethodID and/or CurrencyCode.

Definition: GET /v1/balances/methodID/currencyCode

Where:
  • {methodID} – The ID of the payment method. The payment methods that support payouts are: SEPA Payouts (MethodID = 1), Trustly (MethodID = 29) and Qiwi (MethodID = 1003).
  • {currencyCode} – The currency in which you sell the services or products. Format is according to ISO 4217, a three-letter code.
  • The below request allows you to get all the balances that are active per SiteID without specifying any parameter.

    Request:

    GET https://paytest.smart2pay.com/v1/balances/
    Authorization: Basic MzAyMDE6KzlLZUd6S0Y3VzhTLzc5YTVSMzNZSlVnN0U3V0ZOY1piakdmekxWM2JYU25GQ095RnQ=

    Response:

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    
    {
      "Balances": [
        {
          "MerchantID": 1045,
          "SiteID": 30201,
          "MethodID": 1,
          "CurrencyCode": "EUR",
          "AvailableAmount": 10000.00,
          "Overdraft": 2500.00,
          "LastBalanceUpdateDateTime": "2020-10-29T15:36:10.807"
        },
        {
          "MerchantID": 1045,
          "SiteID": 30201,
          "MethodID": 1,
          "CurrencyCode": "RON",
          "AvailableAmount": 500000.00,
          "Overdraft": 0.00,
          "LastBalanceUpdateDateTime": "2020-10-29T15:36:34.733"
        },
        {
          "MerchantID": 1045,
          "SiteID": 30201,
          "MethodID": 29,
          "CurrencyCode": "EUR",
          "AvailableAmount": 20000.00,
          "Overdraft": 20000.00,
          "LastBalanceUpdateDateTime": "2020-10-29T15:36:21.047"
        }
      ]
    }
  • The below request allows you to get all the balances that are active for your SiteID for a specific payment method.

    Request:

    GET https://paytest.smart2pay.com/v1/balances/1
    Authorization: Basic MzAyMDE6KzlLZUd6S0Y3VzhTLzc5YTVSMzNZSlVnN0U3V0ZOY1piakdmekxWM2JYU25GQ095RnQ=

    Response:

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    
    {
      "Balances": [
        {
          "MerchantID": 1045,
          "SiteID": 30201,
          "MethodID": 1,
          "CurrencyCode": "EUR",
          "AvailableAmount": 10000.00,
          "Overdraft": 2500.00,
          "LastBalanceUpdateDateTime": "2020-10-29T15:36:10.807"
        },
        {
          "MerchantID": 1045,
          "SiteID": 30201,
          "MethodID": 1,
          "CurrencyCode": "RON",
          "AvailableAmount": 500000.00,
          "Overdraft": 0.00,
          "LastBalanceUpdateDateTime": "2020-10-29T15:36:34.733"
        }
      ]
    }
  • The below request allows you to get all the balances that are active for your SiteID for a specific currency.

    Request:

    GET https://paytest.smart2pay.com/v1/balances/EUR
    Authorization: Basic MzAyMDE6KzlLZUd6S0Y3VzhTLzc5YTVSMzNZSlVnN0U3V0ZOY1piakdmekxWM2JYU25GQ095RnQ=

    Response:

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    
    
    
    {
      "Balances": [
        {
          "MerchantID": 1045,
          "SiteID": 30201,
          "MethodID": 1,
          "CurrencyCode": "EUR",
          "AvailableAmount": 10000.00,
          "Overdraft": 2500.00,
          "LastBalanceUpdateDateTime": "2020-10-29T15:36:10.807"
        },
        {
          "MerchantID": 1045,
          "SiteID": 30201,
          "MethodID": 29,
          "CurrencyCode": "EUR",
          "AvailableAmount": 20000.00,
          "Overdraft": 20000.00,
          "LastBalanceUpdateDateTime": "2020-10-29T15:36:21.047"
        }
      ]
    }
  • The below request allows you to get all the balances that are active for your SiteID for a specific payment method and currency.

    Request:

    GET https://paytest.smart2pay.com/v1/balances/1/EUR
    Authorization: Basic MzAyMDE6KzlLZUd6S0Y3VzhTLzc5YTVSMzNZSlVnN0U3V0ZOY1piakdmekxWM2JYU25GQ095RnQ=

    Response:

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    
    {
      "Balances": [
        {
          "MerchantID": 1045,
          "SiteID": 30201,
          "MethodID": 1,
          "CurrencyCode": "EUR",
          "AvailableAmount": 10000.00,
          "Overdraft": 2500.00,
          "LastBalanceUpdateDateTime": "2020-10-29T15:36:10.807"
        }
      ]
    }