#Суффиксы методов: что они значат

#(без суффикса) — каскадный режим

Реквизит банка той страны, к которой относится валюта. RUB → банк РФ, KZT → банк Казахстана, UZS → банк Узбекистана, и т.д. Конкретный банк внутри страны выбирается автоматически из доступного пула.

Запрос: только amount, currency, merchant_transaction_id.

Используйте, когда вам не важен конкретный банк-получатель — главное чтобы платёж в нужной валюте прошёл.

#-internal — конкретный банк/оператор

Реквизит только указанного банка (или мобильного оператора для mobile-internal). Если в пуле этого банка свободных реквизитов нет — придёт ответ без реквизитов (см. секцию выше).

Запрос: общие поля + bank_id (UUID из GET /merchant/banks) или operator_id для mobile-internal.

Используйте, когда нужно жёстко зафиксировать банк получения — например, у клиента карта только конкретного банка.

#-cross — трансграничный платёж

Валюта платежа и страна банка-получателя независимы. Клиент платит в одной валюте, реквизит получает банка из другой страны.

• Тариф — по currency
• Банк — по country_code

Примеры:

• currency=RUB, country_code=TJ → клиент платит рубли, реквизит таджикского банка
• currency=KRW, country_code=TJ → клиент платит воны, реквизит таджикского банка

Запрос: общие поля + country_code (ISO-2).

#qr-nspk — НСПК QR без привязки к банку

Прямой QR через НСПК. Клиент сканирует и платит из любого банка, поддерживающего СБП. Конкретный банк-получатель не фиксируется.

Запрос: только общие поля.

#qr-nspk-multi — Мультитрансфер

Вариант НСПК QR с реквизитом из любых стран (не только national). Используется для максимальной конверсии.

Запрос: только общие поля.

#acquiring — Банковский эквайринг

Hosted Payment Page банка-эквайера (Tinkoff / Сбер / Cloudpayments…). Клиент попадает на checkout-страницу банка и оплачивает картой.

Запрос: общие поля + return_url.

#Сводная таблица

bank_id получаете через GET /merchant/banks?country_code=RU.