Инициализация оплаты в рамках электронной коммерции (C2B2E)
Last updated
Last updated
Данный сценарий описывает инициализацию проведения оплаты за товар/услугу посредством платежной ссылки в рамках электронной коммерции.
Схему успешного сценария процесса «Инициализация оплаты в рамках электронной коммерции (C2B2E)» отображает рисунок ниже.
Примечание: На схеме темно-зелеными квадратами отображены методы (endpoint), которые должны быть реализованы на стороне соответствующего участника для реализации данного сценария. Описание методов приведено в электронном формате в https://transfers-openapi.npck.kz/.
Методы API (endpoint), которые необходимо реализовать каждому участнику на своей стороне в рамках процесса «Инициализация оплаты в рамках электронной коммерции (C2B2E)», приведены в таблице ниже.
Процесс «Инициализация оплаты в рамках электронной коммерции (C2B2E)» построен на обмене сообщениями, основанными на стандарте ISO20022, которые логически связаны между собой.
Описание успешного сценария процесса «Инициализация оплаты в рамках электронной коммерции (C2B2E)»:
Отправитель денег инициирует оплату посредством платежной ссылки.
Банк отправителя денег направляет Платформе запрос данных для оплаты (сообщение admi.009) по ссылке, подписав его своим ЭЦП
В сообщении передается:
в теге <Document:MsgId> – сгенерированный уникальный идентификатор нового сообщения
в теге <Document:SplmtryData:PlcAndNm> с ключом END_TO_END_ID – сгенерированный уникальный идентификатор, который будет выступать в качестве сквозного идентификатора для всей цепочки сообщений в рамках данной операции оплаты
2.1. Платформа, получив запрос, проводит его валидацию, в том числе:
проверяет подпись Банка отправителя денег
проверяет корректность заполнения полей
Платформа направляет в Банк бенефициара запрос данных для оплаты (сообщение admi.009), подписав его ЭЦП Платформы
В сообщении передается:
в теге <Document:MsgId> – сгенерированный уникальный идентификатор нового сообщения
в теге <Document:SplmtryData:PlcAndNm> с ключом END_TO_END_ID –
сквозной идентификатор из сообщения admi.009 Банка отправителя денег
3.1. Банк бенефициара, получив запрос, проводит его обработку, в том числе:
проверяет подпись Платформы
проверяет корректность заполнения полей
выполняет поиск данных по QR-коду, производит сверку контрольной суммы с данными из полученного сообщения admi.009
Банк бенефициара направляет данные для оплаты Платформе (сообщение admi.010), подписав его своим ЭЦП
В сообщении передается:
в теге <Document:MsgId> – сгенерированный уникальный идентификатор нового сообщения
в теге <Document:RptDtls:ReqRef> – сквозной идентификатор из тега <Document::SplmtryData:PlcAndNm> с ключом END_TO_END_ID исходного запроса (admi.009)
4.1. Платформа, получив ответ, проводит его валидацию, в том числе:
проверяет подпись Банка бенефициара
проверяет корректность заполнения полей
Платформа направляет данные для оплаты в Банк отправителя денег (сообщение admi.010), подписав его ЭЦП Платформы
В сообщении передается:
в теге <Document:MsgId> – сгенерированный уникальный идентификатор нового сообщения
в теге <Document:RptDtls:ReqRef> – сквозной идентификатор из тега <Document::SplmtryData:PlcAndNm> с ключом END_TO_END_ID исходного запроса (admi.009)
5.1. Банк отправителя денег, получив ответ, проводит его валидацию, в том числе:
проверяет подпись Платформы
проверяет корректность заполнения полей
Клиент подтверждает проведение оплаты.
Банк отправителя денег проводит проверку счета клиента на:
валидность статуса для его дебетования
отсутствие наложенного ПТП/ РПРО/ ареста и т.п.
достаточности средств для списания суммы операции
Банк отправителя денег блокирует сумму операции по счету клиента и формирует платежное поручение (pacs.008).
Банк отправителя денег направляет Платформе запрос на проведение оплаты (сообщение pacs.008), подписав его своим ЭЦП.
В сообщении передается:
в теге <Document::GrpHdr:MsgId> – сгенерированный уникальный идентификатор нового сообщения
в теге <Document::PmtId:EndToEndId> – сгенерированный уникальный сквозной идентификатор
в поле <Document::PmtId:TxId> – сгенерированный уникальный идентификатор новой транзакции
указывается IBAN для счета Отправителя денег
указывается IBAN для счета Бенефициара
9.1. Платформа, получив запрос, проводит его валидацию, в том числе:
проверяет подпись Банка отправителя денег
проверяет корректность заполнения полей
Если валидация запроса проходит успешно, Платформа направляет ответ с HTTP статусом 200.
Платформа обрабатывает запрос на проведение оплаты (сообщение pacs.008), в том числе:
выполняет проверку позиций участников и лимитов;
выполняет блокирование средств для проведения транзакции.
Платформа направляет в Банк бенефициара запрос на проведение оплаты (сообщение pacs.008), подписав его ЭЦП Платформы.
В сообщении передается:
в теге <Document::GrpHdr:MsgId> – сгенерированный уникальный идентификатор нового сообщения
в теге <Document::PmtId:EndToEndId> – сквозной идентификатор из тега <EndToEndId> сообщения pacs.008 Банка отправителя денег
в поле <Document::PmtId:TxId> – идентификатор транзакции из тега <TxId> из сообщения pacs.008 Банка отправителя денег
указывается IBAN для счета Отправителя денег из сообщения pacs.008 Банка отправителя денег
указывается IBAN для счета Бенефициара из сообщения pacs.008 Банка отправителя денег
11.1. Банк бенефициара, получив запрос, проводит его обработку, в том числе:
проверяет подпись Платформы;
проверяет корректность заполнения полей.
Если валидация запроса проходит успешно, Банк бенефициара направляет ответ с HTTP статусом 200.
Банк бенефициара проверяет счет бенефициара на возможность зачисления денег.
Банк бенефициара направляет статус обработки запроса проведения оплаты Платформе (сообщение pacs.002), подписав его своим ЭЦП.
В сообщении передается:
<Document::OrgnlEndToEndId> – сквозной идентификатор из тега <EndToEndId> исходного запроса (pacs.008)
<Document::OrgnlTxId> – идентификатор транзакции из тега <TxId> исходного запроса (из pacs.008)
Статус транзакции PDNG (в обработке)
13.1. Платформа, получив запрос, проводит его валидацию, в том числе:
проверяет подпись Банка бенефициара;
проверяет корректность заполнения полей.
Если валидация запроса проходит успешно, Платформа направляет ответ с HTTP статусом 200.
Платформа направляет статус обработки запроса проведения оплаты в Банк отправителя денег (сообщение pacs.002), подписав его ЭЦП Платформы.
В сообщении передается:
в теге <Document::OrgnlEndToEndId> – сквозной идентификатор из тега <EndToEndId> исходного запроса (pacs.008)
в теге <Document::OrgnlTxId> – идентификатор транзакции из тега <TxId> исходного запроса (из pacs.008)
Статус транзакции PDNG (в обработке)
14.1. Банк отправителя денег, получив запрос, проводит его валидацию, в том числе:
проверяет подпись Платформы;
проверяет корректность заполнения полей.
Если валидация запроса проходит успешно, Банк отправителя денег направляет ответ с HTTP статусом 200.
Платформа успешно завершает транзакцию (commit transaction).
Платформа направляет в качестве уведомления об успешной транзакции в Банк бенефициара сообщение pacs.002 со статусом транзакции ACSC, подписав его ЭЦП Платформы.
16.1. Банк бенефициара, получив сообщение pacs.002 со статусом транзакции, проводит его валидацию, в том числе:
проверяет подпись Платформы;
проверяет корректность заполнения полей.
Если валидация запроса проходит успешно, Банк бенефициара направляет ответ с HTTP статусом 200.
Примечание: Если Платформа направляет в Банк бенефициара сообщение pacs.002 со статусом транзакции ACSC, и им уже был получен такой же запрос (повторно отправлен pacs.002), то дополнительных действий Банк бенефициара не производит (не производит повторное зачисление денег на счет бенефициара и т.д.), а лишь отправляет ответ с HTTP статусом 200
16.2. Банк бенефициара производит зачисление денег на счет бенефициара и направляет информацию об этом на POS-терминал.
Платформа направляет в качестве уведомления об успешной транзакции в Банк отправителя денег сообщение pacs.002 со статусом транзакции ACSC, подписав его ЭЦП Платформы.
17.1. Банк отправителя денег, получив сообщение pacs.002 со статусом транзакции, проводит его валидацию, в том числе:
проверяет подпись Платформы;
проверяет корректность заполнения полей.
Если валидация запроса проходит успешно, Банк отправителя денег направляет ответ с HTTP статусом 200.
Примечание: Если Платформа направляет в Банк отправителя денег сообщение pacs.002 со статусом транзакции ACSC, и им уже был получен такой же запрос (повторно отправлен pacs.002), то дополнительных действий Банк отправителя денег не производит (не производит повторное списание денег со счета отправителя денег и т.д.), а лишь отправляет ответ с HTTP статусом 200
17.2. Банк отправителя денег производит списание денег со счета отправителя денег и уведомляет его о завершении операции.
Метод API (endpoint) | Банк отправителя денег | Банк бенефициара |
---|---|---|
Запрос данных для оплаты
(POST /v1/transfers/iso20022/admi.009.001.02)
+
Данные для оплаты
(POST /v1/transfers/iso20022/admi.010.001.02)
+
Запрос на перевод денег
(POST /v1/transfers/iso20022/pacs.008.001.11)
+
Статус обработки запроса перевода денег
(POST /v1/transfers/iso20022/pacs.002.001.13)
+
+