Перейти к содержанию

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

Способы, которыми касса принимает деньги, перечисляет 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 в перечне способов.