3.3. Get balance

3.3.1. Get balance flow

For integration purposes use staging environment sandbox.elecsnet.ru instead of production pay.elecsnet.ru. Get balance transactions are initiated through HTTPS POST request by using URL in the following format:

The End point ID is an entry point for incoming Merchant’s transactions for single currency integration.

https://pay.elecsnet.ru/paynet/api/v2/get-balance/ENDPOINTID – for Get balance transaction by End point ID

Get balance also supports checking balance by manager and by merchant login.

https://pay.elecsnet.ru/paynet/api/v2/get-balance/merchant/MERCHANTLOGIN – for Get balance transaction by Merchant login.

https://pay.elecsnet.ru/paynet/api/v2/get-balance/manager/MANAGERLOGIN – for Get balance transaction by Manager login.

Setting up balances

Balances can be configured for managers and merchants via Accounts tab.

../_images/accountstab.png

1. Set up the transaction type and rates(application direction for rates is set manually), which will add or deduct funds from your account. Rates based on transaction amount and statuses may also deduct money from your balance. Optionally, gate and endpoint can be selected - if they are left empty, balance configuration will work for all gates and endpoints of selected manager.

Configuration button

../_images/confbut.png
../_images/adding_config.png

exclamation If at least one operation type is refactored balances will count by refactored configuration and only for refactored operations, if there is no refactor for operation type, than balances will count by main configuration. For balance 38 Sale operation is refactored, that means for this balance main configuration doesn’t affect. Only Sale operation can affect on Balance 38 and will count as set in balance configuration. Example:

../_images/removealert.png
  1. Choose which balances you would like to use - Account balances, Processor balance (balances for acquirer can be set), Card mapping balances and Gate group balances (setting balances for specific list of gates)
../_images/adding_account_balance.png

Default balance must be selected. If balance-name parameter is left empty, get balance will respond with default balance.

  1. Adjustments for balance can be made via Add adjustment button. Adjustment amount and external source of the adjustment are mandatory.
../_images/adding_adjustments.png

Alternatively, adjustments requests via API are available. Please refer to the file example and debugger. Added adjustments as seen in the UI:

../_images/added_adjustments.png

Reconciliation and Export transaction are available per balance.

../_images/recexbut.png
../_images/exporttrans.png

Transaction period pops up after clicking on Export transaction button.

../_images/period_field.png

CSV file contains the following fields:

../_images/csvex.png

Example of configured balance. First balance is funded by sale transaction and defunded by payout and dispute transactions and is set up for USD currency, also merchant rates apply. The other balance is set up for AUD and is only funded by sale transactions, without any rates.

../_images/balance_example.png

Get balance Parameters

In order to initiate a Get balance transaction Merchant sends an HTTPS POST request with the parameters specified in Get balance Request Parameters Table below

Get balance Parameters Mandatory Description
balance-provider Optional Input your balance provider. Only parameter mandatory for get balance by endpoint
balance-name Optional Your balance name. Only parameter mandatory for get balance by login

Adjustments parameters and file example

Adjustments must be sent in archived tsv file format.

Balance Adjustment Parameter Description
Credit amount Credit amount.
Debit amount Debit amount.
External ID Adjustment external ID.
External Merchant ID External merchant ID. Set in properties of merchant/manager.
Balance name Balance name. If parameter is not set, default balance is automatically selected.

tsv file example:

10.45               eid1    THIS_IS_EXT_MERCH_ID    Global merchant balance
90.05               eid2    THIS_IS_EXT_MERCH_ID    Global merchant balance

Get balance Response Parameters

Get balance Response Parameter Description
amount Current balance.
name Balance name.
currency Currency used for selected balance.
merchantLogin Merchant login for the balance.
managerLogin Manager login for the balance.
externalMerchantIdentifier External merchant identifier.

Get balance Response Example

"name":"Global merchant balance","amount":21.400,"currency":"USD","merchantLogin":"obtmerc","externalMerchantIdentifier":"THIS_IS_EXT_MERCH_ID"

Get Balance Debug

File example Adjustments parameters and file example

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
endpoint
url
parameters
version
consumer key
consumer secret
timestamp
nonce
signature method

normalized parameters
signature base string
signature
authorization header

Balance Adjustment Debug

In order to make an adjustment, tsv file must be archived and sent. 7-Zip or similar archiving software is needed in order to use this debugger.

url
Source
Manager login
filename
control key

Get Balance V4 Debug

See OAuth for details.

Order status form
URL input URL
endpointid or groupid input your ENDPOINTID or ENDPOINTGROUPID
login
client_orderid input your Invoice Number
order_id
by-request-sn

Normalized parameters string to sign, according to OAuth 1.0a rules
POST body parameters to submit
OAuth 1.0a headers to submit.
HEX Encoded Signature
* HEX encoded string is for debug purposes only. You shouldn't send this string to the server neither in HEX nor in Encoded HEX representation.
Base64 Encoded Signature
* Binary RSA-SHA256 signature directly encoded in base64 should be sent to the server.