Способы оплаты

Как оставить выбор покупателю или ограничить счёт доступными проекту способами.

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

Когда способ не нужно указывать

Не передавайте method и methods, если покупатель должен выбрать на странице оплаты. Это безопасный вариант по умолчанию: касса покажет только доступные проекту способы.

Как ограничить выбор

Передайте method, чтобы открыть один сценарий, или methods, чтобы оставить несколько. Вместе эти поля использовать нельзя.

{
  "amount": { "amount": "149900", "currency": "RUB" },
  "methods": ["card", "sbp"]
}

Идентификатор	Что видит покупатель	Где проходит ввод
`card`	Карта российского банка	На странице Plateshka
`card_intl`	Карта иностранного банка	На странице Plateshka
`sbp`	СБП	На странице Plateshka
`lolz`	Кошелёк LolzTeam	На стороне провайдера
`xrocket`	Кошелёк XROCKET	На стороне провайдера

Наличие идентификатора в API не означает, что он включён вашему проекту. Недоступный способ возвращает 422 method_unavailable при создании счёта — покупатель не попадёт на пустую кассу.

Факт и ограничение

pinnedMethod показывает ограничение, заданное при создании счёта. method показывает способ, которым в итоге заплатили; до оплаты он равен null.

Что может пойти не так

Способ жёстко задан без проверки настройки проекта.
Повтор с тем же Idempotency-Key, но другим method получает idempotency_conflict.
Секретный API-ключ используется на странице для получения списка способов.

Следующий шаг

Вернитесь к быстрому старту или откройте точную схему создания счёта.