Счета

Для работы со счетами вам потребуются разрешения ReadAccountsBasic, ReadAccountsDetail.

Счёт — это расчётный или иной счёт компании, открытый в банке. У одной компании может быть несколько счетов. Каждый счёт имеет уникальный идентификатор — accountId. Он используется в большинстве методов: получение баланса, выписки, реквизитов и так далее.

Формат accountId

accountId — это номер счёта и БИК банка, записанные через слеш, например:

40817810802000000008/044525104

Идентификатор уникален и не меняется, его длина — 30 символов. Именно это значение подставляется в пути методов, например, в запросе баланса или выписки по конкретному счёту.

Какие методы есть

• Get Accounts List — получить список всех доступных счетов. По каждому приходит accountId и основные атрибуты.
• Get Account Info — получить информацию по конкретному счёту. В запросе передаётся accountId.

Полное описание полей, примеры запросов и ответов можно найти на страницах этих методов в разделе «Методы».

С чего начать

1. Вызовите Get Accounts List и найдите нужный счёт.
2. Сохраните его accountId — он понадобится для баланса, выписок и платежей.
3. При необходимости запросите детали по счёту методом Get Account Info.

Какие данные приходят по счёту

• accountId — уникальный идентификатор счёта (счёт/БИК)
• customerCode — код компании, которой принадлежит счёт
• transitAccount — идентификатор транзитного счёта
• status — статус счёта
• statusUpdateDateTime — дата и время изменения статуса
• currency — валюта счёта, например RUB
• accountType — тип счёта: Business (юрлицо) или Personal (физлицо)
• accountSubType — вид счёта
• registrationDate — дата регистрации счёта
• accountDetails — реквизиты счёта

Что важно знать

• accountId уникален и не меняется — его удобно сохранить сразу после первого запроса и переиспользовать
• Для операций используйте счёт со статусом Enabled

Совет

Узнать остаток по счёту можно методами из раздела Баланс счёта, а операции — в разделе Выписки.