Документация/Приём платежей/Каналы
Каналы и возможности
Канал — это связка провайдера, методов оплаты и валют, доступная вашему ключу. Возможности канала определяют, какие операции вообще применимы к платежу.
Зачем проверять
Перед первой оплатой сверьте нужные валюту и метод с фактическим ответом API, а не с ожиданиями. Набор возможностей канала — это то, чем определяются capture, отмена и возврат: операция, не поддержанная каналом, вернёт 422 capability_not_supported.
Запрос
Запрос
GET /api/v1/payment-channelsОтвет 200
{
"items": [
{
"id": "0198c5f2-7b3e-7a41-9c2d-3f8a1b6e4d02",
"alias": "EUR acquiring",
"payment_methods": ["card"],
"currencies": ["EUR"],
"checkout_mode": "platform"
}
]
}Не хардкодьте внутреннее имя провайдера
alias — человекочитаемая метка канала, а не идентификатор провайдера. Реальное имя PSP, его merchant ID и сырой payload провайдера не раскрываются и меняться могут без изменения контракта.
Возможности канала
Ответ содержит только нейтральные возможности. На них опираются последующие операции:
payment_methods— какие методы оплаты примет канал;currencies— валюты, в которых можно создать операцию;checkout_mode—platformозначает, что карточные данные собирает hosted-страница платформы.
Раздельный capture, частичный возврат и возвраты в принципе — тоже возможности канала. Если они не согласованы, соответствующий вызов вернёт 422, и это ожидаемое поведение, а не сбой.