Запрос расчёта комиссии — сценарий – Портал разработчика

Сценарий демонстрирует ситуацию, в которой Финансовое учреждение-отправитель запрашивает размер комиссии у Финансового учреждения-получателя за обработку Платежа от имени конечного Бенефициара. Применяется до инициализации Платежа.

Открыть в JPG

Шаг 1. Создать запрос на расчёт комиссии за обработку платежа

ОФУ

Финансовому учреждению-отправителю необходимо через конечную точку /payment-points получить пункт выплаты, который обслуживает Финансовое учреждение-получатель и сформировать сведения, необходимые для расчёта комиссии за обработку платежа chargeRequest: расчётный актив и выплачиваемая валюта, детали платежа и идентификатор ОФУ. После этого Участнику требуется сформировать полезную нагрузку и передать её в объекте chargeRequest через конечную точку /charges/request/{member_identification}, где member_identification — идентификатор Участника, у которого запрашивается комиссия за обработку платежа.

Открыть в JPG

Пример запроса

{
  "method": "POST",
  "url": "https://ru.bluebank.payments.tkey7.com/client/v1/api/charges/response/greenbank",
  "headers": {
    "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjYyODkwNDEzNWIyZDgzOWVjZWU1NjU5OCJ9.eyJ2cnNuIjoiMS4wLjAiLCJlbnYiOiJwcm9kIiwiaXAiOlsiMjUxLjI2LjEwOC4xNjMiLCI2Mi4yMDMuMTU2LjIyOCIsIjIxLjQ0LjIwLjIyNyIsIjE0OC4zNC4yMjUuMTUwIiwiMTU4LjE4Ni4yMDAuMTQwIl0sImFjY3QiOlsiZW1pc3Npb24iLCJtYWluIiwicmVzZXJ2ZSIsImRpc3RyaWJ1dGlvbiIsImNvbnNvbGlkYXRlIiwiY2hlY2tpbmciXSwiZW5kcHQiOlsiL2NsaWVudC92MS9hcGkvYmFsYW5jZXMvZGlnaXRhbC1hY2NvdW50cyIsIi9jbGllbnQvdjEvYXBpL2NoYXJnZXMvcmVxdWVzdCIsIi9jbGllbnQvdjEvYXBpL2NoYXJnZXMvcmVzcG9uc2UiLCIvY2xpZW50L3YxL2FwaS9kaWdpdGFsLWFjY291bnRzIiwiL2NsaWVudC92MS9hcGkvZXhjaGFuZ2UiLCIvY2xpZW50L3YxL2FwaS9leGNoYW5nZS9xdW90YXRpb25zIiwiL2NsaWVudC92MS9hcGkvZXhjaGFuZ2UvcXVvdGF0aW9ucy9yZXF1ZXN0IiwiL2NsaWVudC92MS9hcGkvZ2F0ZXdheS9tZXNzYWdlcyIsIi9jbGllbnQvdjEvYXBpL21lbWJlcnMiLCIvY2xpZW50L3YxL2FwaS9wYXltZW50LXBvaW50cyIsIi9jbGllbnQvdjEvYXBpL3BheW1lbnRzL21lc3NhZ2UvcmVkZWVtIiwiL2NsaWVudC92MS9hcGkvcGF5bWVudHMvbWVzc2FnZS9yZXBseSIsIi9jbGllbnQvdjEvYXBpL3BheW1lbnRzL21lc3NhZ2Uvc2VuZCIsIi9jbGllbnQvdjEvYXBpL3NldHRsZW1lbnQtaW5zdHJ1bWVudHMiLCIvY2xpZW50L3YxL2FwaS9zZXR0bGVtZW50LWluc3RydW1lbnRzL2RpZ2l0YWwtYWNjb3VudHMiLCIvY2xpZW50L3YxL2FwaS9zZXR0bGVtZW50LWluc3RydW1lbnRzL21lbWJlcnMiLCIvY2xpZW50L3YxL2FwaS9zZXR0bGVtZW50LW9ibGlnYXRpb25zIiwiL2NsaWVudC92MS9hcGkvc2lnbi9tZXNzYWdlIiwiL2NsaWVudC92MS9hcGkvc2lnbi9wYXlsb2FkIiwiL2NsaWVudC92MS9hcGkvdHJhbnNhY3Rpb25zIl0sImNudCI6MCwiaWF0IjoxNjU4MzkxNDA2LCJuYmYiOjE2NTgzOTE0MDksImV4cCI6MTY1ODQ3NzgwNiwiYXVkIjoiYmx1ZWJhbmsiLCJzdWIiOiItTjJfd2FQQkd2OXJuYmRfUmx1TiIsImp0aSI6IlFLNDN1RDF4Um5EOU1helpkdGF5eWVyMXZEIn0.lhEP1ZyYKgfC8UWnYloULUw00nEL0dxFSm_1WGHVxj0"
  },
  "body": {
    "request_uuid": "24c84863-a56f-42b7-98af-87dffd87c790",
    "member_identification": "bluebank",

Шаг 2. Извлечь запрос комиссии

ПФУ

TKEY7 получит запрос на расчёт комиссии за обработку платежа от Участника ОФУ, и сделает запрос доступным для Участника ПФУ через Шлюзовую службу сообщений Kafka. Финансовому учреждению-получателю необходимо выполнить вызов в конечную точку /gateway/messages с аргументом charge, чтобы извлечь ожидающий ответа запрос расчёта комиссии за обработку платежа.

Открыть в JPG

Пример ответа

{
  "response_data": [
    {
      "request_uuid": "24c84863-a56f-42b7-98af-87dffd87c790",
      "member_identification": "bluebank",
      "interbank_settlement_instrument": {
        "asset_code_identification": "USDDSO",
        "asset_group_identification": "DSO",
        "asset_issuer_identification": "bluebank"

Шаг 3. Отправить ответ на запрос расчёта комиссии за обработку платежа

ПФУ

Финансовому учреждению-получателю необходимо рассчитать комиссию, которая будет взиматься с Участника ОФУ за обработку платежа. После этого Участнику ПФУ требуется сформировать полезную нагрузку paymentCharge и передать её в объекте paymentCharge через конечную точку /charges/response/{member_identification}, где member_identification — идентификатор Участника, который запросил расчёт комиссии за обработку платежа. В ответ TKEY7 вернёт подтверждение об успешной отправке комиссии.

Открыть в JPG

Пример запроса

{
  "method": "POST",
  "url": "https://ch.greenbank.payments.tkey7.com/client/v1/api/charges/response/bluebank",
  "headers": {
    "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjYyODkwNjA1NGE0YmUzNzg1MzU4M2FjYiJ9.eyJ2cnNuIjoiMS4wLjAiLCJlbnYiOiJwcm9kIiwiaXAiOlsiMTAxLjEwMy4yMjEuMjI0IiwiMjMzLjc5LjEyOS4zOSIsIjExNS4xNy4yMTMuMjgiXSwiYWNjdCI6WyJlbWlzc2lvbiIsIm1haW4iLCJzZXR0bGVtZW50Iiwib3BlcmF0aW5nIl0sImVuZHB0IjpbIi9jbGllbnQvdjEvYXBpL2JhbGFuY2VzL2RpZ2l0YWwtYWNjb3VudHMiLCIvY2xpZW50L3YxL2FwaS9jaGFyZ2VzL3JlcXVlc3QiLCIvY2xpZW50L3YxL2FwaS9jaGFyZ2VzL3Jlc3BvbnNlIiwiL2NsaWVudC92MS9hcGkvZGlnaXRhbC1hY2NvdW50cyIsIi9jbGllbnQvdjEvYXBpL2V4Y2hhbmdlIiwiL2NsaWVudC92MS9hcGkvZXhjaGFuZ2UvcXVvdGF0aW9ucyIsIi9jbGllbnQvdjEvYXBpL2V4Y2hhbmdlL3F1b3RhdGlvbnMvcmVxdWVzdCIsIi9jbGllbnQvdjEvYXBpL2dhdGV3YXkvbWVzc2FnZXMiLCIvY2xpZW50L3YxL2FwaS9tZW1iZXJzIiwiL2NsaWVudC92MS9hcGkvcGF5bWVudC1wb2ludHMiLCIvY2xpZW50L3YxL2FwaS9wYXltZW50cy9tZXNzYWdlL3JlZGVlbSIsIi9jbGllbnQvdjEvYXBpL3BheW1lbnRzL21lc3NhZ2UvcmVwbHkiLCIvY2xpZW50L3YxL2FwaS9wYXltZW50cy9tZXNzYWdlL3NlbmQiLCIvY2xpZW50L3YxL2FwaS9zZXR0bGVtZW50LWluc3RydW1lbnRzIiwiL2NsaWVudC92MS9hcGkvc2V0dGxlbWVudC1pbnN0cnVtZW50cy9kaWdpdGFsLWFjY291bnRzIiwiL2NsaWVudC92MS9hcGkvc2V0dGxlbWVudC1pbnN0cnVtZW50cy9tZW1iZXJzIiwiL2NsaWVudC92MS9hcGkvc2V0dGxlbWVudC1vYmxpZ2F0aW9ucyIsIi9jbGllbnQvdjEvYXBpL3NpZ24vbWVzc2FnZSIsIi9jbGllbnQvdjEvYXBpL3NpZ24vcGF5bG9hZCIsIi9jbGllbnQvdjEvYXBpL3RyYW5zYWN0aW9ucyJdLCJjbnQiOjEsImlhdCI6MTY1ODM5NzEwNywibmJmIjoxNjU4Mzk3MTExLCJleHAiOjE2NTgzOTgwMDYsImF1ZCI6ImdyZWVuYmFuayIsInN1YiI6Ii1OMl9WOVdGY2lLNXFMQ2dWTG9BIiwianRpIjoiWFpZWDBGVTFHU1pXUWg0OHpjQlJ1QUMyb3QifQ.EbpXxGaJUVI3hIZ0uIDG3bIIbWJ7JT5va6yRiHkfaMc"
  },
  "body": {
    "fee_amount": 50,
    "instructed_amount": 48460,

Шаг 4. Извлечь ответ на запрос расчёта комиссии за обработку платежа

ОФУ

TKEY7 получит ответ на запрос расчёта комиссии за обработку платежа от Участника ПФУ, и сделает ответ доступным для Участника ОФУ через Шлюзовую службу сообщений Kafka. Финансовому учреждению-отправителю необходимо выполнить вызов в конечную точку /gateway/messages с аргументом charge, чтобы извлечь ответ на запрос расчёта комиссии за обработку платежа. На этом шаге Участник ОФУ может принять дальнейшее решение об инициации платежа, в случае принятия положительного решения, Участнику ОФУ требуется действовать в соответствии с условиями комиссии, чтобы инициировать платёж, см. сценарий: Платёж с помощью ЦРА и Платёж с помощью ЦРО.

Открыть в JPG

Пример ответа

{
  "response_data": [
    {
      "fee_amount": 50,
      "instructed_amount": 48460,
      "instructed_currency_code": "CHF",
      "interbank_settlement_amount_without_fee": 49950,
      "interbank_settlement_instrument": {
        "asset_code_identification": "USDDSO",

Page last updated: 26 November 2022

Сценарии: Выкуп ЦРА

Сценарии: Платёж с помощью ЦРО