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

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

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

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

интеграционные (валидность данных заказа, подпись, PublicId, токены);
банковские отклонения (3‑D Secure, антифрод, эмитент не разрешил операцию);
пользовательские (неверные данные карты, недостаточно средств, CAPTCHA);
бизнес-процессы (подписки, возвраты, чеки).

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

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

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

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

Виджет оплаты: краткое сообщение для держателя карты (CardHolderMessage), иногда — CAPTCHA.
Ответ API/webhook: Success=false, Message, ReasonCode, TransactionId. Подробности — в «CloudPayments API: документация».
Личный кабинет мерчанта: раздел платежей и подписок — см. «My CloudPayments (личный кабинет)».
Почта техконтакта: уведомления об ошибках вебхуков и подписей.

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

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

Проверьте баланс и лимиты интернет-платежей в банке-эмитенте.
Введите корректные данные карты и одноразовый код 3‑D Secure.
Если видите CAPTCHA от CloudPayments — пройдите проверку и повторите оплату.
Попробуйте другой способ: карту другого банка или оплату через «СБП в CloudPayments».
Для подписок: если списание не проходит и «cloudpayments отменить подписку не работает», используйте инструкции «Отмена подписки CloudPayments» или «Найти подписку и отвязать карту».
Нужна помощь — контакты на странице «Поддержка CloudPayments».

Частые коды ошибок 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/антифрод) или отклонением эмитента. В интерфейсе держателю карты показывается безопасное сообщение: «Платёж отклонён банком. Обратитесь в банк или попробуйте другой способ».

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

Ввести корректный 3‑D Secure код, отключить VPN/прокси, перезагрузить браузер.
Проверить лимиты и разрешение интернет-платежей у банка.
Повторить позже или выбрать СБП.

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

Сверить поля в ответе: Success=false, Message, ReasonCode, CardHolderMessage.
Проверить, не блокирует ли антифрод частые попытки одного клиента/IP.
Предложить альтернативный метод оплаты (СБП) в UI.
При стабильных отказах — обратиться в «Поддержку», приложив TransactionId и логи.

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

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

CloudPayments error: Order cost invalid

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

Amount равна 0 либо отрицательная;
дробная часть > 2 знаков (например, 10.999);
неверный формат (10,50 вместо 10.50);
сумма платежа не совпадает с суммой заказа/инвойса;
валюта платежа не соответствует валюте заказа.

Решение:

Всегда передавайте сумму как десятичное число с точкой и двумя знаками: 123.45;
Убедитесь, что итог после скидок/доставки совпадает с Amount;
Отключите локализацию чисел при сериализации (InvariantCulture);
Проверьте валюту и округление на бэкенде;
Сверьте OrderId и сумму через «Проверку платежа».

CAPTCHA от CloudPayments

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

Что делать:

Плательщику — корректно пройти CAPTCHA и оплатить ещё раз.
Мерчанту — ограничить повторные попытки, включить антибот-логику на фронтенде, загрузить виджет только с официального домена, сверить интеграцию по «API-докам».

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

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

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

неверный SubscriptionId;
подписка уже отменена/истёкшая;
нет прав у текущего мерчанта (другой аккаунт);
техническая ошибка вебхука.

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

Найдите и проверьте подписку в личном кабинете — «My CloudPayments».
Сверьте идентификатор и статус; изучите логи вебхуков отмены.
Повторите отмену по инструкции «Отмена подписки CloudPayments».
Если пользователь просит деактивировать привязку карты — дайте ссылку «Найти подписку и отвязать карту».
При необходимости оформите возврат по операции — «Возврат денег CloudPayments».

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

Подпись: проверяйте HMAC для всех уведомлений. См. «CloudPayments API: документация».
PublicId/среда: не путайте тест и прод, проверьте «Widget PublicId».
Суммы и валюта: используйте InvariantCulture и точку как разделитель; не больше 2 знаков.
Повторы: защита от дублирующих оплат (идемпотентность по OrderId/TransactionId).
Таймауты и ретраи: корректно обрабатывайте повторные вебхуки.
Тестирование: используйте «Тестовые карты и демо».
Подписки: корректно храните SubscriptionId и состояние, не полагайтесь только на фронтенд-сигналы.
Плагины: если используете CMS, проверьте «Интеграции и плагины».
Доступы: вход только через «Merchant: вход» по защищённым каналам.

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

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

СБП: ошибки чаще связаны с тайм-аутами подтверждения клиента в банке, недоступностью банка-участника, отменой в приложении. Дайте пользователю кнопку «Отправить ссылку/QR ещё раз» и альтернативу картой. Подробнее — «CloudPayments СБП».
Международные платежи: возможны ограничения по валютам и странам, SCA/3‑D Secure 2.0. Проверьте подключение «международных платежей» и «тарифы и комиссии».

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

Возврат: при ошибке после списания оформите полный/частичный возврат — «Возврат денег CloudPayments».
Чеки: при неуспешной оплате чек не формируется; при возврате — чек коррекции/возврата. Подробно — «Чеки и касса CloudPayments».
Повтор: делайте повтор только после подтверждённой ошибки и исправления причины, чтобы избежать дублей.

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

Почему списание не прошло, а деньги «заморожены»? Часто это холд от банка при отклонении 3‑D Secure. Обычно автоматически размораживается. При вопросах — «Поддержка».
Как понять, на чьей стороне ошибка? Смотрите Message/ReasonCode и логи: интеграция (подпись/сумма) vs. эмитент (3DS/лимиты). Если сомневаетесь — в «документацию API» и в поддержку.
Можно ли обойти 5204? Нет «обхода» — это решение банка/3DS. Предложите альтернативу (СБП) или другую карту, проверьте антифрод-настройки.
Где официальный сайт и логотип? См. «Официальный сайт и логотип CloudPayments».
Где почитать отзывы о провайдере? Раздел «Отзывы о CloudPayments».

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

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

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

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