Баланс
Запрос баланса можно использовать для уточнения данных баланса счета.
Запрос
Info
API запроса баланса зависит от банка-эквайера (некоторые банки требуют в запросе параметр account
, некоторые - currency
). Обратитесь к своему Аккаунт-менеджеру для уточнения параметров запроса.
Запрос баланса должен быть отправлен как POST
запрос на https://gateway.pay-cross.com/balance
с заголовком X-API-Version: 2
и следующими параметрами:
Параметр | Тип | Описание |
---|---|---|
account * условно обязательный |
string | Номер счета (если поле пустое, то вернется информация о счете по умолчанию). |
currency * условно обязательный |
string | Валюта в ISO-4217 формате, например USD . |
gateway_id * условно обязательный |
string | ID банка, шлюза в системе PayCross. |
Пример запроса баланса по номеру счета
{
"request":{
"account":"40701810842020395221"
}
}
Пример запроса баланса по валюте
{
"request":{
"currency":"USD"
}
}
Пример запроса баланса по ID банка
{
"request":{
"gateway_id":"1"
}
}
Ответ
Параметр | Тип | Описание |
---|---|---|
status * обязательный |
string | Статус ответа. |
result * обязательный |
object | Результат ответа. |
gatewayId * обязательный |
integer | ID банка, шлюза в системе PayCross. |
account | string | Номер счета. |
amount | integer | Баланс счета в минимальных денежных единицах. |
currency | string | Валюта. Указывается, если банк сообщил ее в ответе или если банк обрабатывает транзакции лишь в одной валюте. |
bankInfo | object | Дополнительная информация в предоставленном банком формате. |
Пример ответа
{
"status": "successful",
"result": {
"gatewayId": 5,
"account": "40701810820020300021",
"amount": 6623871674,
"currency": "RUB",
"bankInfo": {
"Account": "40701810820020300021",
"Amount": 66238716.74,
"Balance": {
"OperDate": "2021-12-15T00:00:00",
"Credit": 0.0,
"CreditRub": 0.0,
"Debit": 0.0,
"DebitRub": 0.0,
"AmountIn": 132339134.78,
"AmountInRub": 132339134.78,
"AmountOut": 132339134.78,
"AmountOutRub": 132339134.78
}
}
}
}