2.3. Get balance

2.3.1. Get balance by Endpoint ID

POST https://gate.fyst.com/paynet/api/v2/get-balance/{endpoint_id}

Path parameter

  • endpoint_id – Merchant endpoint identifier.

Content type

  • Request: application/x-www-form-urlencoded
  • Response: text/html; charset=utf-8
    All fields are returned as x-www-form-urlencoded key=value pairs, each terminated by a newline character (0x0A).

Authentication

The checksum is used to ensure that it is Merchant (and not a fraudster) that sends the request to FYST. This SHA-1 checksum, the parameter control, is created by concatenation of these parameters values in the following order:

  • login – your Merchant login.
  • merchant_control – your Control Key.

Request Parameters

Get balance by Endpoint ID Request Parameters Mandatory Description
currency Optional If omitted, balances for all currencies are returned.

Response Parameters

  • When currency is omitted, the response contains multiple amount/currency pairs.
  • When a single currency is requested, exactly one pair is returned (or none if not available).
Response Parameters Description
amount Available balance amount. Repeated per currency.
currency Repeated per currency.

Response Example

amount=29.99
currency=USD

Postman Collection

Debug

Using HMAC-SHA1

To reproduce your API call, input all of the data from your original request, including the authentication tokens. Don’t forget to set the nonce and timestamp to the values you used. An OAuth signed URL should match regardless of the generating library. If the signatures differ, you know there is a bug in your OAuth signature code.

HTTP method
url
parameters
consumer secret

normalized parameters
signature base string
signature
authorization header