Способы оплаты¶
Способы, которыми касса принимает деньги, перечисляет GET /v1/payment-methods. Ответ зависит
от ключа: по тестовому ключу вы видите способы песочницы, по боевому — боевые (FR-API-012).
Два разных «доступно»¶
В ответе два поля, и они отвечают на разные вопросы. Их легко спутать, а действия по ним противоположные.
| Поле | Вопрос | Что делать, если «нет» |
|---|---|---|
available |
Можно ли вам сейчас платить этим способом? | Проверить настройки кассы: способ мог быть выключен, под него может не быть маршрута, провайдер мог не отвечать |
availability |
Запустила ли касса этот способ вообще? | Ничего: coming_soon означает, что приём готовится на нашей стороне |
availability: coming_soon — это обещание кассы, а не состояние вашей кассы. Платёж с таким
способом отклоняется 422 method_unavailable ещё на создании, до того как покупатель увидит
страницу оплаты.
Что доступно сейчас¶
| Способ | type |
Боевой контур | Песочница |
|---|---|---|---|
| СБП | sbp |
available |
available |
| Банковская карта | bank_card |
coming_soon |
available |
Остальные значения PaymentMethodType в боевом контуре не возвращаются вовсе: перечень «того,
что когда-нибудь будет» — это список планов, а не способов.
Карту можно интегрировать уже сейчас. В песочнице она работает полностью: создание платежа, страница оплаты, успех и отказ. К моменту запуска боевого приёма ваш код будет готов, и переключение сведётся к смене ключа.
Пример ответа¶
{
"items": [
{
"type": "sbp",
"title": "СБП",
"available": true,
"availability": "available",
"currencies": ["RUB"],
"min_amount": { "value": "1.00", "currency": "RUB" },
"two_stage": false,
"partial_refund": true
},
{
"type": "bank_card",
"title": "Банковская карта",
"available": false,
"availability": "coming_soon",
"currencies": ["RUB"],
"two_stage": true,
"partial_refund": true
}
]
}
title — название способа для человека, на языке магазина. Держать свой словарь
bank_card → «Банковская карта» не нужно: он всё равно разойдётся с нашим.
Отказ при создании платежа¶
{
"type": "error",
"code": "method_unavailable",
"description": "способ оплаты bank_card пока недоступен в боевом контуре; в песочнице он работает",
"parameter": "payment_method.type",
"request_id": "req_01J8Z3H4M5N6P7Q8R9S0T1V2W3"
}
Код один и тот же во всех случаях, когда способ не проходит: выключен в настройках вашей
кассы, не поддержан провайдером, ещё не запущен кассой. Отдельного кода под «скоро» нет
намеренно — справочник Error.code заморожен, а для клиента все три случая означают одно:
«этим способом не получится, выберите другой». Что именно произошло, сказано в
description; а узнать заранее, не пробуя, можно по availability в перечне способов.