Перейти к основному содержимому

Методы оплаты

Метод передаётся в параметре method при создании платежа и определяет, каким способом плательщик совершает перевод. Доступность метода зависит от страны — см. Валюты и страны.

Перечень методов

Значение передаётся в параметре method при создании платежа.

МетодРеквизит для оплатыrequisites.typeОписание
CARDНомер картыcardПеревод на банковскую карту
PHONEНомер телефонаphoneПеревод по номеру телефона внутри банка. Применяется в странах, где перевод по номеру не относится к СБП — например Казахстан
SBPНомер телефонаsbpПеревод по номеру телефона через СБП. Только Россия
SBP_QRQR-кодqrОплата по QR-коду СБП. Только Россия
SIMНомер телефонаsimПополнение лицевого счёта абонента мобильного оператора. Только Россия
CROSS_BORDERНомер телефонаphoneТрансграничный перевод: amount в рублях, плательщик вносит сумму в местной валюте
CROSS_BORDER_CARDНомер картыcardТо же, перевод на карту
CROSS_BORDER_SIMНомер телефонаsimТрансграничное пополнение лицевого счёта абонента у оператора связи. amount в рублях, плательщик вносит сумму в местной валюте

Параметр bank

Параметр bank ограничивает подбор реквизитов указанным банком.

Для методов CARD, SBP и SBP_QR передача bank переводит платёж в режим внутрибанковского перевода: плательщик и получатель находятся в одном банке. Если такое ограничение не требуется, параметр передавать не следует — без него доступно больше реквизитов и выше вероятность успешного подбора.

Для метода PHONE параметр bank задаёт банк получателя и режим платежа не меняет.

Для метода CROSS_BORDER_SIM в bank передаётся код оператора связи (tcell, babilon_mobile, megafon_tjs, beeline_tj, zet_mobile). Режим платежа он не меняет — это фильтр, ограничивающий подбор реквизитов одним оператором. Без него реквизит подбирается среди всех операторов страны из параметра country.

Методы по странам

СтранаДоступные методы
Россия (RUB)CARD, SBP, SBP_QR, SIM
Казахстан (KZT)CARD, PHONE, CROSS_BORDER, CROSS_BORDER_CARD
Азербайджан (AZN)CARD, PHONE
Таджикистан (TJS)CARD, CROSS_BORDER, CROSS_BORDER_CARD, CROSS_BORDER_SIM

Казахстан доступен в двух режимах. Приём в тенге — методы CARD и PHONE с параметром currency: "KZT", сумма указывается в тенге. Приём в рублях — методы CROSS_BORDER и CROSS_BORDER_CARD с параметром country: "KZ", сумма указывается в рублях, конвертация в тенге выполняется системой.

Таджикистан дополнительно принимает CROSS_BORDER_SIM — пополнение счёта у оператора связи; подробнее в разделе Валюты и страны.

Методы CROSS_BORDER и CROSS_BORDER_CARD задаются параметром country и доступны для всех поддерживаемых стран приёма. Сумма по умолчанию рублёвая, но может передаваться и в валюте страны приёма — через тот же currency. Подробнее — в разделе Валюты и страны.

Если метод недоступен для указанной страны либо реквизиты по нему отсутствуют, возвращается 503 с кодом PAY_004.