Ошибки CloudPayments: коды, причины и решения (5204, Order cost invalid и др.)

Получить CloudPayments бесплатно

Ошибки CloudPayments: коды, причины и решения (5204, Order cost invalid и др.)

Table of contents

Кому пригодится и как устроены ошибки CloudPayments

Эта статья — практический путеводитель по ошибкам оплаты в CloudPayments: коды, расшифровки и рабочие решения. Материал полезен владельцам интернет-магазинов, разработчикам и пользователям, которые видят в виджете или письме «cloudpayments error» и не знают, что делать дальше.

Условно ошибки делятся на:

Если вы только знакомитесь с системой — начните со страницы «Что такое CloudPayments».

Где увидеть код и текст ошибки

Ошибки проявляются в разных точках:

Совет: фиксируйте сырые ответы API и заголовки подписи — это ускорит разбор.

Быстрые решения для плательщика

Частые коды ошибок CloudPayments и что они значат

Ниже — типовые случаи. Точные значения ReasonCode и рекомендации всегда уточняйте в ответе API и в «документации».

Где возникает Пример сообщения/кода Возможная причина Что делать
API/виджет Order cost invalid Неверная сумма: 0 или отрицательная, >2 знаков после запятой, не совпадает с суммой заказа/инвойса, ошибка локали (запятая вместо точки) Передавайте Amount с точкой, двумя знаками, валюта соответствует заказу; синхронизируйте сумму заказа и платежа; проверьте тип данных
Банковское отклонение ReasonCode 5204 / Payment declined / 3‑D Secure failed Доп. проверка не пройдена, банк-эмитент отклонил, антифрод Повторить платеж (список выше), использовать другую карту/СБП; мерчанту — собрать логи, проверить 3DS и антифрод-настройки
API Invalid signature / HMAC mismatch Подпись запроса/вебхука рассчитана с ошибкой или с неверным секретом Пересчитать HMAC по документации, сверить секретный ключ, порядок полей; см. «API: документация»
Виджет CAPTCHA required Система заметила необычную активность (много попыток, автозаполнение, прокси) Пройти CAPTCHA; снизить число повторов; мерчанту проверить домен и источник скриптов
Подписки Subscription not found / Already canceled Неверный идентификатор подписки, уже отменена, истёк токен Сверить SubscriptionId, статус; см. «Отмена подписки»
API PublicId not found / invalid Неправильный PublicId или среда (test/prod) Проверить «Widget PublicId» и окружение
API Token expired/invalid Просроченный криптограм-токен карты/сессии Запросить новый токен (перезагрузить виджет)
Заказ Invoice/OrderId not found Платёж пытается провести несуществующий/закрытый заказ Сверить OrderId, статус заказа; см. «Проверка платежа»
SBP Bank unavailable / Timeout Временная недоступность банка-участника, клиент не подтвердил платёж Повторить оплату, отправить ссылку повторно; предложить карту
Валюта Currency not supported Для мерчанта не подключены нужные валюты Подключить «международные платежи» или сменить валюту

Примечание: набор ReasonCode может расширяться; проверяйте актуальную таблицу в «документации API».

Разбор популярных случаев: 5204, Order cost invalid, CAPTCHA

Код ошибки 5204 CloudPayments

Что это: часто встречающийся внутренний код отказа, связанный с дополнительной проверкой (3‑D Secure/антифрод) или отклонением эмитента. В интерфейсе держателю карты показывается безопасное сообщение: «Платёж отклонён банком. Обратитесь в банк или попробуйте другой способ».

Что делать плательщику:

Что делать мерчанту:

Мини-образец ответа:

{
  "Success": false,
  "Message": "Payment declined",
  "Model": {
    "ReasonCode": 5204,
    "CardHolderMessage": "Платёж отклонён банком"
  }
}

CloudPayments error: Order cost invalid

Симптом: в API/виджете — «Order cost invalid». Причины:

Решение:

CAPTCHA от CloudPayments

CAPTCHA появляется при аномальной активности: множественные неуспешные попытки, быстрые повторы, подозрительные User-Agent или прокси.

Что делать:

![Схема: когда появляется CAPTCHA в CloudPayments](alt: простая схема появления CAPTCHA при множественных попытках и аномальной активности)

«Не получается отменить подписку» — что делать

Запрос «cloudpayments отменить подписку не работает» встречается часто. Причины:

План действий:

Чек-лист для разработчиков и интеграторов

![Диаграмма потока: обработка ошибки оплаты и ретраев](alt: блок-схема от попытки оплаты через виджет до вебхука и повторной попытки)

SBP и международные платежи: специфика ошибок

Возвраты, чеки и повтор платежа

FAQ: коротко о главном

Вывод и что делать дальше

Ошибки оплаты неизбежны, но их можно быстро диагностировать и исправлять, если знать, где смотреть код/сообщение и какие шаги предпринимать. Запомните три правила: корректные суммы и подписи (интеграция), прозрачные сценарии для пользователя (виджет/СБП/ретраи) и своевременная коммуникация (чаты поддержки, статусы в ЛК).

Готовы навести порядок? Проверьте интеграцию по «API-документации», настройте «интеграции и плагины», а при спорных кейсах — сразу пишите в «поддержку». Если проблема в подписках — начните с «Отмена подписки» и «Проверка платежа». Так вы сократите число отказов и улучшите конверсию.

Получить CloudPayments бесплатно