forked from apoloz/alfa-bank-sdk
276 lines
17 KiB
Markdown
276 lines
17 KiB
Markdown
|
||
Общие положения
|
||
|
||
Каналы взаимодействия
|
||
|
||
1. Взаимодействие с хостом Альфа-Банка осуществляется через сеть Интернет по протоколу HTTP(S) с использованием клиентских
|
||
сертификатов RSA/TLS.
|
||
|
||
2. Порядок выпуска, установки и применения сертификатов определяется Удостоверяющим Центром Заказчика и не является пред
|
||
данных ТУ, за исключением требований к имени (алиас) сертификатов на прокси-сервере Заказчика:
|
||
|
||
• Имя (алиас) сертификата должно соответствовать коду терминала запроса и реквизиту заголовка запроса key-name;
|
||
|
||
• При проверке соединения используется сертификат с именем равным обязательному параметру TermNo тела запроса и реквиз
|
||
заголовка запроса key-name.
|
||
|
||
Идентификация Виртуального терминала
|
||
|
||
Описание по идентификации
|
||
|
||
1. Каждый виртуальный терминал получает регистрационный номер (далее — «TermNo»).
|
||
|
||
2. TermNo требуется для определения виртуального терминала, кассы или системы.
|
||
|
||
3. Для каждого адреса ТСП присваивается минимум 1 виртуальный терминал и максимум по запросу.
|
||
|
||
4. TermNo определяет принадлежность терминала ЮЛ и конкретному ТСП, а также расчетный счет ЮЛ в системе Заказчика, на кото
|
||
будут поступать средства покупателей.
|
||
|
||
5. TermNo сохраняется в настройках виртуального терминала и с клиентским сертификатом используется в информационном обмен
|
||
на прикладном уровне протокола взаимодействия.
|
||
|
||
6. Оплата производится покупателями самостоятельно, необходимая для оплаты информация передается покупателю посредством
|
||
кода СБП, отображаемом на экране Агент ТСПа, или распечатанном на чеке или кассе или ссылке и т. д.
|
||
|
||
7. Получение динамических QR-кодов СБП и проверка их оплаты осуществляются с обязательным использованием TermNo.
|
||
|
||
Общий порядок работы
|
||
|
||
Оплата покупки через СБП
|
||
|
||
1. Кассир указывает на терминале (в случае кассового решения получает из ПО кассы) следующие параметры:
|
||
|
||
• Сумма;
|
||
|
||
• Валюта (подставляются автоматически);
|
||
|
||
• Назначение платежа (подставляется автоматически).
|
||
|
||
2. ТСП запрашивает динамический QR-код;
|
||
|
||
3. ТСП отображает полученное изображение (или печатает предварительный чек с изображением);
|
||
|
||
4. Покупатель:
|
||
|
||
• сканирует QR-код в приложении своего смартфона;
|
||
|
||
• получает и проверяет необходимую для подтверждения доп. информацию;
|
||
|
||
• подтверждает оплату;
|
||
|
||
• сообщает о проведении оплаты кассиру.
|
||
|
||
5. Кассир на терминале запрашивает подтверждение оплаты;
|
||
|
||
6. ТСП запрашивает подтверждение оплаты полученного ранее QR-кода
|
||
|
||
12/23/25, 11:21 AM Общие положения
|
||
|
||
https://alfabank.ru/sme/payservice/sbp/docs/general/?rp-menuOpen=1 1/4
|
||
|
||
|
||
|
||
7. Получив подтверждение, ТСП печатает чек оплаты QR-кода с указанием:
|
||
|
||
• qrcId
|
||
|
||
• кода транзакции СБП
|
||
|
||
• даты и времени оплаты QR-кода
|
||
Возврат покупки через СБП
|
||
|
||
Особенность возврата покупки через ТСП:
|
||
|
||
1. Требует обязательного наличия чека и указания кода транзакции СБП;
|
||
|
||
2. Может производиться исключительно:
|
||
|
||
• по идентификатору плательщика (номеру телефона), осуществившего оплату;
|
||
|
||
• возврат средств возможен только в Банк-участник СБП из которого проводилась оплата;
|
||
|
||
• возврат осуществляется на счет плательщика, предназначенный для приема переводов СБП (счет по умолчанию для номера
|
||
телефона получателя).
|
||
|
||
Кассир указывает на терминале следующие параметры:
|
||
|
||
1. Сумма возврата покупки (частичного возврата);
|
||
|
||
2. Валюта;
|
||
|
||
3. Назначение платежа;
|
||
|
||
4. Данные из чека оплаты QR-кода покупателя:
|
||
|
||
• Код транзакции СБП;
|
||
|
||
• qrcId;
|
||
|
||
• Дату оплаты QR-кода.
|
||
|
||
ТСП запрашивает возможность возврата оплаты QR-кода;
|
||
|
||
После подтверждения возможности возврата:
|
||
|
||
• На хосте Банка найдена исходная операция и имеются все необходимые данные для возврата, кассир указывает на терминале
|
||
одноразовый код подтверждения возврата (порядок получения кассиром одноразового кода подтверждения (SMS/PUSH сообще
|
||
или производится иная аутоинтефикация ответственного пользователя, обладающего правом выполнения подобны действий.
|
||
|
||
• Любой способ проверки полномочий сотрудника ЮЛ совершать возвраты, если таковой необходим оговаривается отдельно.
|
||
|
||
ТСП запрашивает возврат и печатает чек возврата с указанием:
|
||
|
||
Данные из чека оплаты QR-кода покупателя: * Код транзакции «payrnn»; * Сумма возврата, может быть меньше или равна сумме,
|
||
указанной в чеке оплаты; * Конечный список используемых при возврате параметров может быть измен, оговаривается отдельно.
|
||
|
||
Регистрация кассовой ссылки
|
||
|
||
• ТСП отправляет запрос на создание кассовой ссылки Агенту ТСП;
|
||
|
||
• Агент ТСП отправляет запрос на создание кассовой ссылки в ОПКЦ СБП;
|
||
|
||
• ОПКЦ СБП возвращает данные новой Кассовой ссылки Агенту ТСП;
|
||
|
||
• Агент ТСП передает данные Кассовой ссылки в ТСП
|
||
|
||
• Агент ТСП размещает QR-код с данными Кассовой ссылки у кассы или иными аналогичными способами для возможности считыва
|
||
его электронными устройствами клиентов (смартфон, планшет и т. п.) в процессе оплаты ими покупок.
|
||
|
||
Активация кассовой ссылки
|
||
|
||
1. ТСП направляет запрос на активацию Кассовой ссылки Агенту ТСП;
|
||
|
||
• В запросе активации ТСП передает идентификатор ранее зарегистрированной кассовой ссылки и параметры оплаты;
|
||
|
||
• В параметрах оплаты обязательно следует передавать сумму платежа, валюту платежа и назначение платежа, а также другие
|
||
служебные параметры запроса, описанные в спецификации.
|
||
|
||
• Для получения уведомлений о статусе оплаты по активированной ссылке ТСП должно передать в специальном параметре запр
|
||
активации адрес для коллбеков с уведомлением от НСПК о статусе операций оплаты.
|
||
|
||
2. Агент ТСП передает запрос на активацию Кассовой ссылки в ОПКЦ СБП;
|
||
|
||
12/23/25, 11:21 AM Общие положения
|
||
|
||
https://alfabank.ru/sme/payservice/sbp/docs/general/?rp-menuOpen=1 2/4
|
||
|
||
|
||
|
||
3. ОПКЦ СБП передает Агенту ТСП уведомление об активации Кассовой ссылки;
|
||
|
||
4. Агент ТСП передает в ТСП уведомление об активации Кассовой ссылки;
|
||
|
||
5. ТСП сообщает клиенту о возможности оплаты по QR-коду, полученного в процессе создания (регистрации) кассовой ссылки, кото
|
||
клиент может считать с помощью своего электронного устройства;
|
||
|
||
6. Клиент производит оплату C2B с помощью своего электронного устройства;
|
||
|
||
7. Агент ТСП получает уведомление от НСПК о финальном статусе операции C2B;
|
||
|
||
8. ТСП запрашивает статус операции у Агента ТСП или получает уведомление о статусе операции в случае, если ранее в запросе
|
||
активации кассовой ссылки был передан адрес для коллбеков с уведомлением о статусе оплат.
|
||
|
||
Деактивация кассовой ссылки
|
||
|
||
1. Клиент или ТСП принимает решение об отсутствии возможности или необходимости оплаты по ранее активированной кассовой
|
||
ссылке;
|
||
|
||
2. ТСП отправляет запрос Агенту ТСП на деактивацию кассовой ссылки;
|
||
|
||
3. Агент ТСП передает запрос на деактивацию Кассовой ссылки в ОПКЦ СБП;
|
||
|
||
4. ОПКЦ деактивирует ссылку и передает Агенту ТСП оповещение об этом;
|
||
|
||
5. Агент ТСП передает оповещение о деактивации ссылки в ТСП.
|
||
|
||
Возврат по ранее оплаченной кассовой ссылке
|
||
|
||
a) Для возврата по ранее оплаченной кассовой ссылке отличий от ранее реализованных процессов возврата по операциям C2B нет
|
||
за исключением того, что обязательно требуется передавать значение параметра «payrrn» без «qrcid».
|
||
|
||
Изменение счета ТСП для ранее зарегистрированной кассовой ссылки
|
||
|
||
a) ТСП принимает решение о необходимости смены счета, который был использован в процессе создания (регистрации) кассовой
|
||
платежной ссылки;
|
||
|
||
b) ТСП обращается с запросом о изменении счета по ранее зарегистрированной кассовой ссылке к Агенту ТСП;
|
||
|
||
c) Агент ТСП передает запрос о смене счета в НСПК;
|
||
|
||
d) НСПК сообщает о результате выполнения запроса Агенту ТСП;
|
||
|
||
e) ТСП уточняет статус операции смены счета у Агента ТСП. Автоматического уведомления ТСП о смене счета по ранее
|
||
зарегистрированной кассовой ссылки не поддерживается.
|
||
|
||
Регистрация QR-кода для привязки счета
|
||
|
||
1. ТСП регистрирует QR-код с типом «03» для привязки счета клиента к функциональности оплат по инициативе ТСП;
|
||
|
||
2. Агент ТСП передает запрос на регистрацию QR-кода для привязки счета в НСПК;
|
||
|
||
3. Клиент считывает QR-код при помощи своего электронного устройства;
|
||
|
||
4. Банк Плательщика получает данные QR-кода из запроса в НСПК;
|
||
|
||
5. Банк Плательщика отображает детали привязки счета на электронном устройстве Клиенту;
|
||
|
||
6. Клиент принимает решение о привязке счета;
|
||
|
||
7. Банк плательщика сообщает о решении клиента в НСПК;
|
||
|
||
8. НСПК сообщает Агенту ТСП о решении по привязке счета;
|
||
|
||
9. ТСП получает уведомление о статусе совершенной Плательщиком привязки счета в случае, если в запросе на регистрацию QR-ко
|
||
был передан адрес для коллбеков.
|
||
|
||
Регистрация QR-кода для оплаты с привязкой счета
|
||
|
||
1. ТСП регистрирует QR-код для оплаты как описано в пункте «Оплата покупки через СБП», но с дополнительным параметром
|
||
«subscriptionPurpose»;
|
||
|
||
2. После успешного завершения оплаты по QR-коду Банк Плательщика должен инициировать на электронном устройстве клиента
|
||
сценарий получения решения клиента по привязке счета для оплат по инициативе ТСП, оплату в пользу которого только что сов
|
||
клиент;
|
||
|
||
3. Банк Плательщика отображает детали привязки счета на электронном устройстве Клиенту;
|
||
|
||
12/23/25, 11:21 AM Общие положения
|
||
|
||
https://alfabank.ru/sme/payservice/sbp/docs/general/?rp-menuOpen=1 3/4
|
||
|
||
|
||
|
||
4. Клиент принимает решение о привязке счета;
|
||
|
||
5. Банк плательщика сообщает о решении клиента в НСПК;
|
||
|
||
6. НСПК сообщает Агенту ТСП о решении по привязке счета;
|
||
|
||
7. ТСП получает уведомление о статусе совершенной Плательщиком привязки счета в случае, если в запросе на регистрацию QR-ко
|
||
был передан адрес для коллбеков.
|
||
|
||
Оплата с привязанного счета по инициативе ТСП
|
||
|
||
1. ТСП регистрирует QR-код для оплаты с привязанного счета;
|
||
|
||
2. Агент ТСП передает запрос регистрации QR в НСПК;
|
||
|
||
3. ТСП направляет запрос оплаты с привязанного счета в НСПК;
|
||
|
||
4. НСПК направляет запрос оплаты с привязанного счета в Банк Плательщика;
|
||
|
||
5. Банк Плательщика сообщает о своем решении по оплате с привязанного счета своего клиента в пользу ТСП из запроса НСПК;
|
||
|
||
6. НСПК Сообщает Агенту ТСП о решении Банка плательщика об оплате с привязанного счета;
|
||
|
||
7. Банк Плательщика начинает операцию C2B;
|
||
|
||
8. НСПК уведомляет Агента ТСП о финальном статусе операции C2B.
|
||
|
||
12/23/25, 11:21 AM Общие положения
|
||
|
||
https://alfabank.ru/sme/payservice/sbp/docs/general/?rp-menuOpen=1 4/4
|
||
|
||
|