Hasan/alfa-bank-sdk
1
0
Fork 0
forked from apoloz/alfa-bank-sdk
Code Pull Requests Activity
Files
e23e2ea6df9dcaffcfa5ff1ab20f9d053f79d1aa
alfa-bank-sdk/_docs/alfabank/qr_payout/2_general_provisions.md

17 KiB
Raw Blame History

Общие положения

Каналы взаимодействия

  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. Кассир указывает на терминале (в случае кассового решения получает из ПО кассы) следующие параметры:

• Сумма;

• Валюта (подставляются автоматически);

• Назначение платежа (подставляется автоматически).

  1. ТСП запрашивает динамический QR-код;

  2. ТСП отображает полученное изображение (или печатает предварительный чек с изображением);

  3. Покупатель:

• сканирует QR-код в приложении своего смартфона;

• получает и проверяет необходимую для подтверждения доп. информацию;

• подтверждает оплату;

• сообщает о проведении оплаты кассиру.

  1. Кассир на терминале запрашивает подтверждение оплаты;

  2. ТСП запрашивает подтверждение оплаты полученного ранее QR-кода

12/23/25, 11:21 AM Общие положения

https://alfabank.ru/sme/payservice/sbp/docs/general/?rp-menuOpen=1 1/4

  1. Получив подтверждение, ТСП печатает чек оплаты QR-кода с указанием:

•  qrcId

• кода транзакции СБП

• даты и времени оплаты QR-кода Возврат покупки через СБП

Особенность возврата покупки через ТСП:

  1. Требует обязательного наличия чека и указания кода транзакции СБП;

  2. Может производиться исключительно:

• по идентификатору плательщика (номеру телефона), осуществившего оплату;

• возврат средств возможен только в Банк-участник СБП из которого проводилась оплата;

• возврат осуществляется на счет плательщика, предназначенный для приема переводов СБП (счет по умолчанию для номера телефона получателя).

Кассир указывает на терминале следующие параметры:

  1. Сумма возврата покупки (частичного возврата);

  2. Валюта;

  3. Назначение платежа;

  4. Данные из чека оплаты QR-кода покупателя:

• Код транзакции СБП;

• qrcId;

• Дату оплаты QR-кода.

ТСП запрашивает возможность возврата оплаты QR-кода;

После подтверждения возможности возврата:

• На хосте Банка найдена исходная операция и имеются все необходимые данные для возврата, кассир указывает на терминале одноразовый код подтверждения возврата (порядок получения кассиром одноразового кода подтверждения (SMS/PUSH сообще или производится иная аутоинтефикация ответственного пользователя, обладающего правом выполнения подобны действий.

• Любой способ проверки полномочий сотрудника ЮЛ совершать возвраты, если таковой необходим оговаривается отдельно.

ТСП запрашивает возврат и печатает чек возврата с указанием:

Данные из чека оплаты QR-кода покупателя: * Код транзакции «payrnn»; * Сумма возврата, может быть меньше или равна сумме, указанной в чеке оплаты; * Конечный список используемых при возврате параметров может быть измен, оговаривается отдельно.

Регистрация кассовой ссылки

• ТСП отправляет запрос на создание кассовой ссылки Агенту ТСП;

• Агент ТСП отправляет запрос на создание кассовой ссылки в ОПКЦ СБП;

• ОПКЦ СБП возвращает данные новой Кассовой ссылки Агенту ТСП;

• Агент ТСП передает данные Кассовой ссылки в ТСП

• Агент ТСП размещает QR-код с данными Кассовой ссылки у кассы или иными аналогичными способами для возможности считыва его электронными устройствами клиентов (смартфон, планшет и т. п.) в процессе оплаты ими покупок.

Активация кассовой ссылки

  1. ТСП направляет запрос на активацию Кассовой ссылки Агенту ТСП;

• В запросе активации ТСП передает идентификатор ранее зарегистрированной кассовой ссылки и параметры оплаты;

• В параметрах оплаты обязательно следует передавать сумму платежа, валюту платежа и назначение платежа, а также другие служебные параметры запроса, описанные в спецификации.

• Для получения уведомлений о статусе оплаты по активированной ссылке ТСП должно передать в специальном параметре запр активации адрес для коллбеков с уведомлением от НСПК о статусе операций оплаты.

  1. Агент ТСП передает запрос на активацию Кассовой ссылки в ОПКЦ СБП;

12/23/25, 11:21 AM Общие положения

https://alfabank.ru/sme/payservice/sbp/docs/general/?rp-menuOpen=1 2/4

  1. ОПКЦ СБП передает Агенту ТСП уведомление об активации Кассовой ссылки;

  2. Агент ТСП передает в ТСП уведомление об активации Кассовой ссылки;

  3. ТСП сообщает клиенту о возможности оплаты по QR-коду, полученного в процессе создания (регистрации) кассовой ссылки, кото клиент может считать с помощью своего электронного устройства;

  4. Клиент производит оплату C2B с помощью своего электронного устройства;

  5. Агент ТСП получает уведомление от НСПК о финальном статусе операции C2B;

  6. ТСП запрашивает статус операции у Агента ТСП или получает уведомление о статусе операции в случае, если ранее в запросе активации кассовой ссылки был передан адрес для коллбеков с уведомлением о статусе оплат.

Деактивация кассовой ссылки

  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

  1. Клиент принимает решение о привязке счета;

  2. Банк плательщика сообщает о решении клиента в НСПК;

  3. НСПК сообщает Агенту ТСП о решении по привязке счета;

  4. ТСП получает уведомление о статусе совершенной Плательщиком привязки счета в случае, если в запросе на регистрацию 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

View Git Blame Copy Permalink