Обзор¶
Электронные кошельки “Процессинговый сервис” — сервис, позволяющий хранить электронные денежные средства (далее по тексту — ЭДС), пополнять их баланс и распоряжаться ими: переводить на банковскую карту, другой электронный кошелек и т.д.
Управлять ЭДС можно с помощью “Процессинговый сервис” Wallet API. Получать информацию об электронных кошельках (а также операциях с их использованием) можно как с помощью API, так и личного кабинета. Для этого необходимо зарегистрироваться в личном кабинете и получить API-ключ.
Ниже приведено описание основных терминов и понятий, которыми оперирует платформа.
Информация
Терминология, правила и ограничения сервиса реализованы с учетом требований Регуляторов отрасли (в частности, Федерального закона от 27.06.2011 N 161-ФЗ).
Личность¶
Цифровая личность (identity) — это структура, описывающая личность участника платформы.
Более одной личности одновременно могут относиться к одному и тому же участнику платформы. Каждая личность может являться владельцем более одного электронного кошелька и приемника денежных средств.
Кошелек¶
Электронный кошелек (wallet) — сущность, в рамках которой ведётся учёт баланса ЭДС.
Основные сценарии использования¶
- Пополнение баланса ЭДС со счета магазина.
- Вывод средств одним из указанных в
resource→typeспособов.
Подробнее со сценариями пополнения и вывода средств можно ознакомиться в соответствующих разделах данного портала.
Валюта¶
Валюта ЭДС определяется при создании кошелька параметром currency.
Информация
При выводе средств валюта кошелька, валюта операции, и валюта приемника средств должны совпадать.
Управление операциями вывода ЭДС¶
Совершить операцию вывода ЭДС с баланса кошелька может:
- владелец кошелька;
- пользователь, получивший на это право.
Пользователь
Учетная запись, которой соответствует уникальный ключ для доступа к функциональности платформы по API.
Получение права на вывод средств
Владельцу кошелька/приемника средств необходимо выпустить токен, подтверждающий право на осуществление данной операции, и предоставить его другому пользователю. Пользователь в свою очередь должен передать полученное значение в параметре walletGrant/destinationGrant соответствующего запроса.
Платформа оперирует двумя видами токенов:
- walletGrant — позволяет вывести ЭДС с указанного электронного кошелька (walletID);
- destinationGrant — позволяет вывести ЭДС на указанный приемник денежных средств (destinationID).
Пользователь, получивший walletGrant, вправе вывести средства с баланса кошелька владельца, выпустившего токен. Пользователь, получивший destinationGrant вправе вывести ЭДС с баланса своего кошелька на приемник денежных средств другого пользователя (владельца токена).
Каждый токен имеет строго ограниченный срок жизни, по истечении которого автоматически становится недействительными. Срок действия токена определяется параметром validUntil в соответствующем запросе на выдачу прав.
Приемник денежных средств¶
Приемник средств (destination) — сущность платформы, хранящая данные о назначении платежа при выводе денежных средств с баланса электронного кошелька.
Вид назначения (способ, которым можно вывести средства) определяется содержимым параметра type запроса на создание приемника (см. список значений resource→ type).