Запрос расчёта комиссии — сценарий
Сценарий демонстрирует ситуацию, в которой Финансовое учреждение-отправитель запрашивает размер комиссии у Финансового учреждения-получателя за обработку Платежа от имени конечного Бенефициара. Применяется до инициализации Платежа.
Шаг 1. Создать запрос на расчёт комиссии за обработку платежа
Финансовому учреждению-отправителю необходимо через конечную точку /payment-points получить пункт выплаты, который обслуживает Финансовое учреждение-получатель и сформировать сведения, необходимые для расчёта комиссии за обработку платежа chargeRequest: расчётный актив и выплачиваемая валюта, детали платежа и идентификатор ОФУ. После этого Участнику требуется сформировать полезную нагрузку и передать её в объекте chargeRequest
через конечную точку /charges/request/{member_identification}, где member_identification
— идентификатор Участника, у которого запрашивается комиссия за обработку платежа.
Пример запроса
{"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
, чтобы извлечь ожидающий ответа запрос расчёта комиссии за обработку платежа.
Пример ответа
{"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 вернёт подтверждение об успешной отправке комиссии.
Пример запроса
{"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
, чтобы извлечь ответ на запрос расчёта комиссии за обработку платежа. На этом шаге Участник ОФУ может принять дальнейшее решение об инициации платежа, в случае принятия положительного решения, Участнику ОФУ требуется действовать в соответствии с условиями комиссии, чтобы инициировать платёж, см. сценарий: Платёж с помощью ЦРА и Платёж с помощью ЦРО.
Пример ответа
{"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",