Get information on Payouts 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/payoutsbalance/methodID/currencyCode

Where:
  • {methodID} – The ID of the payment method: SEPA Payouts (MethodID = 1), Trustly (MethodID = 29).
  • {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/payoutsbalance/
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,
      "LastBalanceUpdateDateTime": "2020-10-29T15:36:10.807"
    },
    {
      "MerchantID": 1045,
      "SiteID": 30201,
      "MethodID": 1,
      "CurrencyCode": "RON",
      "AvailableAmount": 500000.00,
      "LastBalanceUpdateDateTime": "2020-10-29T15:36:34.733"
    },
    {
      "MerchantID": 1045,
      "SiteID": 30201,
      "MethodID": 29,
      "CurrencyCode": "EUR",
      "AvailableAmount": 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/payoutsbalance/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,
      "LastBalanceUpdateDateTime": "2020-10-29T15:36:10.807"
    },
    {
      "MerchantID": 1045,
      "SiteID": 30201,
      "MethodID": 1,
      "CurrencyCode": "RON",
      "AvailableAmount": 500000.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/payoutsbalance/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,
      "LastBalanceUpdateDateTime": "2020-10-29T15:36:10.807"
    },
    {
      "MerchantID": 1045,
      "SiteID": 30201,
      "MethodID": 29,
      "CurrencyCode": "EUR",
      "AvailableAmount": 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/payoutsbalance/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,
      "LastBalanceUpdateDateTime": "2020-10-29T15:36:10.807"
    }
  ]
}