Инициализация выставления счета на оплату ФЛ от ЮЛ (C2B2_RTP)

Данный сценарий описывает инициализацию процесса выставления счета на оплату от одного юридического лица (ЮЛ) в одном БВУ (Банк Бенефициара) другому физическому лицу (ФЛ), обслуживаемому в другом БВУ (Банк отправителя денег).

Методы API (endpoint), которые необходимо реализовать

При реализации участниками информационного взаимодействия данные API должны быть идемпотентны (получив повторный запрос с теми же параметрами, должен выдаваться в ответе результат исходного запроса).

Схему успешного сценария процесса «Инициализация выставления счета на оплату ФЛ от ЮЛ(C2B2_RTP)» отображает рисунок ниже.

Схема процесса «Инициализация выставления счета на оплату ФЛ от ЮЛ(C2B2_RTP)»

Примечание: На схеме темно-зелеными квадратами отображены методы (endpoint), которые должны быть реализованы на стороне соответствующего участника для реализации данного сценария. Описание методов приведено в электронном формате в https://transfers-openapi.npck.kz/.

Методы API (endpoint), которые необходимо реализовать каждому участнику на своей стороне в рамках процесса «Инициализация выставления счета на оплату ФЛ от ЮЛ(C2B2_RTP)», приведены в таблице ниже.

Метод API (endpoint)	Банк отправителя денег	Банк бенефициара
Запрос верификации наличия счета клиента (POST /v1/transfers/iso20022/acmt.023.001.03)	+
Результат верификации наличия счета клиента (POST /v1/transfers/iso20022/acmt.024.001.03)		+
Запрос на осуществление платежа (POST /v1/transfers/iso20022/ pain.013.001.11)	+
Отчет о статусе запроса на осуществление платежа (POST /v1/transfers/iso20022/ pain.014.001.11)		+
Запрос на перевод денег (POST /v1/transfers/iso20022/pacs.008.001.11)		+
Статус обработки запроса перевода денег (POST /v1/transfers/iso20022/pacs.002.001.13)	+	+

Взаимосвязь идентификаторов сообщений

Успешный процесс «Инициализация выставления счета на оплату ФЛ от ЮЛ(C2B2_RTP)» построен на обмене сообщениями, основанными на стандарте ISO20022, которые логически связаны между собой.

Логическая схема взаимосвязи идентификаторов сообщений

Неуспешный процесс «Инициализация выставления счета на оплату ФЛ от ЮЛ(C2B2_RTP)» построен на обмене сообщениями, основанными на стандарте ISO20022, которые логически связаны между собой.

Логическая схема взаимосвязи идентификаторов сообщений

Описание процесса

Описание успешного сценария процесса «Инициализация выставления счета на оплату ФЛ от ЮЛ(C2B2_RTP)»:

1. Верификация наличия счета клиента

1.1. Бенефициар в приложении Банка бенефициара инициирует запрос на осуществление платежа от отправителя денег по номеру телефона.

1.2. Банк бенефициара направляет Платформе запрос верификации наличия счета клиента по номеру телефона (сообщение acmt.023), подписывая его своим ЭЦП.

Возможные неуспешные сценарии

• Платформа не отвечает:

1. Если Платформа не направляет ответ, то Банк бенефициара должен считать, что запрос не доставлен.

2. Банк бенефициара выполняет попытку повторной отправки корректного запроса в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Платформа направляет Банку отправителя денег ответ с соответствующим ошибке HTTP статусом.

2. Процесс завершается неуспешно.

1.3. Платформа, получив запрос, проводит его обработку и валидацию, в том числе:

• проверяет подпись Банка бенефициара

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Платформа направляет ответ с HTTP статусом 200.

1.4. Платформа направляет в Банк отправителя денег запрос верификации наличия счета клиента по номеру телефона (сообщение acmt.023), подписывая его ЭЦП Платформы.

Возможные неуспешные сценарии

• Банк отправителя денег не отвечает:

1. Платформа завершает процесс, не получив ответ в срок в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

2. Платформа направляет в Банк бенефициара сообщение acmt.024 с ошибкой.

3. Банк бенефициара завершает процесс, получив сообщение с информацией об ошибке.

4. Процесс завершается неуспешно.

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Банк отправителя денег направляет ответ Платформе с соответствующим ошибке HTTP статусом.

2. Платформа завершает процесс, получив сообщение с информацией об ошибке.

3. Платформа направляет в Банк бенефициара сообщение acmt.024 с ошибкой.

4. Банк бенефициара завершает процесс, получив сообщение с информацией об ошибке.

5. Процесс завершается неуспешно.

1.5. Банк отправителя денег, получив запрос, проводит его обработку, в том числе:

• проверяет подпись Платформы

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Банк отправителя денег направляет ответ с HTTP статусом 200.

1.6. Банк отправителя денег проверяет наличие счета по указанному в запросе номеру телефона.

1.7. Банк отправителя денег направляет результат верификации наличия счета клиента Платформе (сообщение acmt.024), подписав его своим ЭЦП.

Возможные неуспешные сценарии

• Платформа не отвечает:

1. Если Платформа не направляет ответ, то Банк отправителя денег должен считать, что запрос не доставлен.

2. Банк отправителя денег выполняет попытку повторной отправки запроса в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Платформа направляет ответ Банку отравителя денег с соответствующим ошибке HTTP статусом.

2. Банк бенефициара завершает процесс, не получив ответ в срок в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

3. Процесс завершается неуспешно.

• Сведения о счете клиента не найдены:

1. Банк отправителя денег направляет негативный результат верификации наличия счета клиента Платформе (сообщение acmt.024).

2. Платформа направляет негативный результат верификации наличия счета клиента Банку бенефициара (сообщение acmt.024).

3. Процесс завершается неуспешно.

1.8. Платформа, получив запрос (сообщение acmt.024), проводит его валидацию, в том числе:

• проверяет подпись Банка отправителя денег

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Платформа направляет ответ с HTTP статусом 200.

1.9. Платформа направляет результат верификации наличия счета клиента в Банк бенефициара (сообщение acmt.024), подписав его ЭЦП Платформы.

Возможные неуспешные сценарии

• Банк бенефициара не отвечает:

1. Если Банк бенефициара не направляет ответ, то Платформа должна считать, что запрос не доставлен.

2. Платформа выполняет попытку повторной отправки запроса в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

1.10. Банк бенефициара, получив запрос, проводит его валидацию, в том числе:

• проверяет подпись Платформы

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Банк бенефициара направляет ответ с HTTP статусом 200.

1.11. Банк бенефициара отображает информацию об отправителе денег (ФИО), чтобы Бенефициар мог удостовериться в корректности получателя.

1.12. Бенефициар подтверждает перевод в приложении Банка бенефициара.

1. Выставление счета на оплату

2.1. Бенефициар (ЮЛ) инициирует выставление счета с указанием суммы платежа.

2.2. Банк бенефициара направляет Платформе запрос на осуществление платежа от отправителя денег (сообщение pain.013), подписав его своим ЭЦП.

Возможные неуспешные сценарии

• Платформа не отвечает:

1. Если Платформа не направляет ответ, то Банк бенефициара должен считать, что запрос не доставлен.

2. Банк бенефициара выполняет попытку повторной отправки корректного запроса в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Платформа направляет Банку отправителя денег ответ с соответствующим ошибке HTTP статусом.

2. Процесс завершается неуспешно.

2.3. Платформа, получив запрос, проводит его обработку и валидацию, в том числе:

• проверяет подпись Банка бенефициара

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Платформа направляет ответ с HTTP статусом 200.

2.4. Платформа направляет в Банк отправителя денег запрос на осуществление платежа от отправителя денег (сообщение pain.013), подписав его ЭЦП Платформы.

Возможные неуспешные сценарии

• Банк отправителя денег не отвечает:

1. Платформа завершает процесс, не получив ответ в срок в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

2. Платформа направляет в Банк бенефициара сообщение pain.014 с ошибкой.

3. Банк бенефициара завершает процесс, получив сообщение с информацией об ошибке.

4. Процесс завершается неуспешно.

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Банк отправителя денег направляет ответ Платформе с соответствующим ошибке HTTP статусом.

2. Платформа завершает процесс, получив сообщение с информацией об ошибке.

3. Платформа направляет в Банк бенефициара сообщение pain.014 с ошибкой.

4. Банк бенефициара завершает процесс, получив сообщение с информацией об ошибке.

5. Процесс завершается неуспешно.

2.5. Банк отправителя денег, получив запрос, проводит его обработку, в том числе:

• проверяет подпись Платформы

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Банк отправителя денег направляет ответ с HTTP статусом 200.

2.6. Банк отправителя денег принимает сообщение pain.013 и отображает информацию о счете клиенту–отправителю денег (ФЛ) через мобильное приложение.

2.6.1. Уведомление клиента и срок действия счета:

• После успешной обработки сообщения pain.013 Банк отправителя денег инициирует направление клиенту–отправителю денег (ФЛ) push-уведомления о выставлении счета Бенефициаром (ЮЛ).

• С момента получения Банком отправителя денег сообщения pain.013 запускается таймер срока действия счета.

• Срок действия счета составляет 24 часа. В течение указанного времени клиент–отправитель денег может подтвердить оплату счета.

• По истечении 24 часов с момента выставления счета, при отсутствии подтверждения оплаты со стороны клиента–отправителя денег, счет автоматически переводится в неактивный статус и становится недоступным для оплаты.

2.7. Отправитель денег просматривает выставленный счет и подтверждает согласие на его оплату.

2.8. Отказ оплаты выставленного счета

2.8.1. Отправитель денег отклоняет счет на оплату:

• Банк отправителя денег направляет статус обработки запроса перевода денег Платформе (сообщение pain.014), подписав его своим ЭЦП, со статусом транзакции RJCT (отклонена).

Возможные неуспешные сценарии

• Платформа не отвечает:

1. Банк отправителя денег завершает процесс, не получив ответ в срок в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

2. Процесс завершается неуспешно.

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Платформа направляет Банку отправителя денег ответ с соответствующим ошибке HTTP статусом.

2. Процесс завершается неуспешно.

• Платформа направляет статус обработки запроса перевода денег в Банк бенефициара (сообщение pain.014 со статусом RJCT), подписав его ЭЦП Платформы, со статусом транзакции RJCT (отклонена).

Возможные неуспешные сценарии

• Банк бенефициара не отвечает:

1. Платформа завершает процесс, не получив ответ в срок в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

2. Процесс завершается неуспешно.

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Банк бенефициара направляет ответ Платформе с соответствующим ошибке HTTP статусом.

2. Платформа завершает процесс, получив сообщение с информацией об ошибке.

3. Процесс завершается неуспешно.

• Банк бенефициара, получив запрос, проводит его обработку, в том числе:

• проверяет подпись Платформы

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Банк бенефициара направляет ответ с HTTP статусом 200.

2.8.2. Отправитель денег не совершает оплату в течение 24 часов с момента выставления счета:

• Процесс завершается неуспешно.

1. Транзакция по проведению платежа

3.1. Банк отправителя денег проводит проверку счета клиента на:

• валидность статуса для его дебетования

• отсутствие наложенного ПТП/ РПРО/ ареста и т.п.

• достаточности средств для списания суммы операции

Возможные неуспешные сценарии

• Проверка счета не прошла успешно:

1. Банк отправителя денег уведомляет клиента о невозможности проведения операции.

2. Процесс завершается неуспешно.

3.2. Банк отправителя денег блокирует сумму операции по счету клиента и формирует платежное поручение (pacs.008).

3.3. Банк отправителя денег направляет Платформе запрос на перевод денег (сообщение pacs.008), подписав его своим ЭЦП.

Возможные неуспешные сценарии

• Платформа не отвечает:

1. Если Платформа не направляет ответ, то Банк отправителя денег должен считать, что запрос не доставлен

2. Банк отправителя денег выполняет попытку повторной отправки корректного запроса в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Платформа направляет Банку отправителя денег ответ с соответствующим ошибке HTTP статусом.

2. Процесс завершается неуспешно.

3.4. Платформа, получив запрос, проводит его валидацию, в том числе:

• проверяет подпись Банка отправителя денег

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Платформа направляет ответ с HTTP статусом 200.

3.5. Платформа обрабатывает запрос на перевод денег (сообщение pacs.008), в том числе:

• выполняет проверку позиций участников и лимитов

• выполняет блокирование средств для проведения транзакции

Возможные неуспешные сценарии

• Обработка запроса на перевод денег pacs.008 Платформой не проходит успешно:

1. Платформа направляет статус обработки запроса перевода денег в Банк отправителя денег (сообщение pacs.002), подписав его ЭЦП Платформы, со статусом транзакции RJCT (отклонена).

2. Процесс завершается неуспешно.

3.6. Платформа направляет в Банк бенефициара запрос на перевод денег (сообщение pacs.008), подписав его ЭЦП Платформы.

Возможные неуспешные сценарии

• Банк бенефициара не отвечает:

1. Если Банк бенефициара не направляет ответ, то Платформа должна считать, что запрос не доставлен.

2. Платформа выполняет попытку повторной отправки запроса в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

3. Платформа завершает процесс, не получив ответ в срок в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

4. Платформа направляет в Банк отправителя сообщение pacs.002 с ошибкой.

5. Банк отправителя денег завершает процесс, получив сообщение с информацией об ошибке.

6. Процесс завершается неуспешно.

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Банк бенефициара направляет ответ Платформе с соответствующим ошибке HTTP статусом.

2. Платформа устанавливает статус транзакции RJCT (отклонена).

3. Платформа направляет в Банк отправителя сообщение pacs.002 с ошибкой.

4. Банк отправителя денег завершает процесс, получив сообщение с информацией об ошибке, устанавливает статус транзакции RJCT (отклонена).

5. Процесс завершается неуспешно.

3.7. Банк бенефициара, получив запрос, проводит его обработку, в том числе:

• проверяет подпись Платформы

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Банк бенефициара направляет ответ с HTTP статусом 200.

3.8. Банк бенефициара проверяет счет бенефициара на возможность зачисления денег.

3.9. Банк бенефициара направляет статус обработки запроса перевода денег Платформе (сообщение pacs.002 со статусом PDNG), подписав его своим ЭЦП.

Возможные неуспешные сценарии

• Платформа не отвечает:

1. Если Платформа не направляет ответ, то Банк бенефициара должен считать, что запрос не доставлен.

2. Банк бенефициара выполняет попытку повторной отправки запроса в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

• Валидация сообщения не прошла успешно:

1. Валидация сообщения не проходит успешно, Платформа направляет ответ Банку бенефициара с соответствующим ошибке HTTP статусом. Банк бенефициара устанавливает статус транзакции RJCT (отклонена).

2. Платформа устанавливает статус транзакции статусом RJCT (отклонена).

3. Банк отправителя денег, не получив ответ в срок в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов), устанавливает статус транзакции RJCT (отклонена).

4. Процесс завершается неуспешно.

• Транзакция отклонена (статус транзакции RJCT):

1. Банк бенефициара направляет Платформе статус обработки запроса перевода денег (сообщение pacs.002) - RJCT (отклонена).

2. Платформа направляет статус обработки запроса перевода денег в Банк отправителя денег (сообщение pacs.002), подписав его ЭЦП Платформы, со статусом транзакции RJCT (отклонена).

3. Процесс завершается неуспешно.

3.10. Платформа, получив запрос, проводит его валидацию, в том числе:

• проверяет подпись Банка бенефициара

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Платформа направляет ответ с HTTP статусом 200.

3.11. Платформа направляет статус обработки запроса перевода денег в Банк отправителя денег (сообщение pacs.002 со статусом PDNG), подписав его ЭЦП Платформы.

Возможные неуспешные сценарии

• Банк отправителя денег не отвечает::

1. Если Банк отправителя денег не направляет ответ, то Платформа должна считать, что запрос не доставлен.

2. Платформа выполняет попытку повторной отправки запроса в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

3.12. Банк отправителя денег, получив запрос, проводит его валидацию, в том числе:

• проверяет подпись Платформы

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Банк отправителя денег направляет ответ с HTTP статусом 200.

3.13. Платформа успешно завершает транзакцию (commit transaction).

3.14. Платформа направляет в качестве уведомления об успешной транзакции в Банк бенефициара сообщение pacs.002 со статусом транзакции ACSC, подписав его ЭЦП Платформы.

3.15. Банк бенефициара, получив сообщение pacs.002 со статусом транзакции, проводит его валидацию, в том числе:

• проверяет подпись Платформы

• проверяет подпись Платформы

• Если валидация запроса проходит успешно, Банк отправителя денег направляет ответ с HTTP статусом 200.

Примечание: Если Платформа направляет в Банк бенефициара сообщение pacs.002 со статусом транзакции ACSC, и им уже был получен такой же запрос (повторно отправлен pacs.002), то дополнительных действий Банк бенефициара не производит (не производит повторное зачисление денег на счет бенефициара и т.д.), а лишь отправляет ответ с HTTP статусом 200

Возможные неуспешные сценарии

• Банк бенефициара не получил сообщение pacs.002 с финальным статусом транзакции (ACSC или RJCT):

1. Банк бенефициара ожидает получение сообщения pacs.002 с финальным статусом транзакции (ACSC или RJCT) в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

2. Не получив сообщения pacs.002 с финальным статусом транзакции (ACSC или RJCT), Банк бенефициара в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов) завершает транзакцию неуспешно (RJCT) по тайм-ауту, зачисление средств бенефициару не производится.

3. Платформа производит откат транзакции, устанавливает статус транзакции - RJCT (неуспешно). Банк отправителя денег, получив статус транзакции RJCT (неуспешно), разблокирует средства Отправителя денег, списание средств не производится.

Примечание: перед завершением транзакции Банк бенефициара может проверить статус транзакции на Платформе, отравив сообщение pacs.028 (см. Сервис получения статуса обработки транзакции)

3.16. Банк бенефициара производит зачисление денег на счет бенефициара и уведомляет об этом бенефициара.

3.17. Платформа направляет в качестве уведомления об успешной транзакции в Банк отправителя денег сообщение pacs.002 со статусом транзакции ACSC, подписав его ЭЦП Платформы.

Возможные неуспешные сценарии

• Банк отправителя денег не отвечает:

1. Если Банк отправителя денег не направляет ответ, то Платформа должна считать, что запрос не доставлен.

2. Платформа выполняет попытку повторной отправки запроса в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

3.18. Банк отправителя денег, получив сообщение pacs.002 со статусом транзакции, проводит его валидацию, в том числе:

• проверяет подпись Платформы

• проверяет корректность заполнения полей

Если валидация запроса проходит успешно, Банк отправителя денег направляет ответ с HTTP статусом 200.

Возможные неуспешные сценарии

• Банк отправителя денег не получил сообщение pacs.002 с финальным статусом транзакции (ACSC или RJCT):

1. Банк отправителя денег ожидает получение сообщения pacs.002 с финальным статусом транзакции (ACSC или RJCT) в соответствии с установленным регламентом (см. Тайм-ауты и логика повторных запросов).

2. Не получив сообщения pacs.002 с финальным статусом транзакции (ACSC или RJCT), Банк отправителя денег направляет запрос статуса транзакции Платформе (сообщение pacs.028, см. Сервис получения статуса обработки транзакции), подписав его своим ЭЦП.

3. Платформа, успешно выполнив обработку запроса, направляет ответ с HTTP статусом 200.

4. Платформа направляет в Банк отправителя денег сообщение pacs.002 со статусом транзакции, подписав его ЭЦП Платформы.

Примечание: Если Платформа направляет в Банк отправителя денег сообщение pacs.002 со статусом транзакции ACSC, и им уже был получен такой же запрос (повторно отправлен pacs.002), то дополнительных действий Банк отправителя денег не производит (не производит повторное списание денег со счета отправителя денег и т.д.), а лишь отправляет ответ с HTTP статусом 200

3.19. Банк отправителя денег производит списание денег со счета отправителя денег и уведомляет его о завершении операции.