Prodamus отправляет итоговый статус платежа методом POST. При успешной обработке endpoint должен вернуть HTTP 200.
Документация: https://help.prodamus.ru/payform/tekhnicheskaya-dokumentaciya/webhook-ob-oplate
| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
Sign |
header | string | да | HMAC-подпись входящего тела |
date |
body | string | да | Дата платежа |
order_id |
body | number | да | ID заказа в Prodamus |
order_num |
body | string | да | Номер заказа на стороне магазина; может быть пустым |
sum |
body | string | да | Сумма заказа |
currency |
body | string | да | rub, usd или eur |
attempt |
body | string | да | Номер попытки доставки |
products |
body | array | да | Корзина товаров |
products[i].name |
body | string | да | Наименование товара |
products[i].price |
body | number | да | Цена за единицу |
products[i].quantity |
body | integer | да | Количество |
payment_status |
body | string | да | success, order_canceled или order_denied |
payment_status_description |
body | string | да | Расшифровка статуса |
payment_init |
body | string | да | api, auto или manual |
https://<subdomain>.payform.ruhttps://widget.prodamus.ru/src/init.jshttps://widget.prodamus.ru/src/init.cssdemo_mode=1Тип: Другое
Секретный ключ доступен в настройках платёжной страницы в блоке «Секретный ключ». Для создания платёжных ссылок, управления подписками и вызова GET или POST /rest/payment/do/ данные запроса без поля signature рекурсивно приводят к строкам, сортируют по ключам, преобразуют в JSON, экранируют / и подписывают HMAC SHA-256. Готовые реализации Hmac.php, hmac.js, prodamus_hmac.py, HmacHelper.cs, HmacHelper.java и hmac.go опубликованы на страницах документации.
Входящий webhook подписан в заголовке Sign; подпись проверяется тем же секретным ключом платёжной страницы. Для оплаты по связке поддержка выдаёт отдельный ключ, привязанный к sys; ключ платёжной страницы используют только для первого платежа.
Для GET /rest/receipt/getReceipts и GET /rest/payment-methods/getList передаются заголовки Timestamp и Authorization: Bearer <token>, где <token> = base64_encode(<timestamp> . md5(<SECRET_KEY>)).
urlSuccess и клиентские редиректы не подтверждают поступление денег. Выдавай товар или доступ только после проверенного webhook с payment_status=success.signature; значения приводятся к строкам, ключи сортируются рекурсивно, JSON подписывается HMAC SHA-256 после экранирования /.application/x-www-form-urlencoded, а тестовый чек-лист ожидает multipart/form-data; для callbackType=json приходит application/json. Приёмник должен разбирать фактически выбранный формат до проверки Sign.attempt может увеличиваться. Обработчик должен быть идемпотентным и отвечать HTTP 200 только после успешной обработки.subscription корзина products игнорируется. После деактивации подписки от лица пользователя повторная активация невозможна; нужно оформить подписку заново./rest/payment/do/ — отдельный ключ от поддержки, привязанный к sys.{"success":true} от /rest/payment/do/ подтверждает только инициацию. Итог проверяется по webhook с payment_init=api.GET /rest/payment-methods/getList Timestamp может быть любой непустой строкой: сервер не проверяет формат или актуальность, срок запроса не ограничен и защиты от повторного воспроизведения нет.Content-Type объявляет charset=WINDOWS-1251; это отдельно отмечено в примерах C#.postMessage гарантированно доступны для карт РФ, СБП и Сбербанк-онлайн. Для других способов оплаты используй webhook.available_payment_methods отфильтровал все способы, параметр игнорируется и показывается полный список; если пустой результат дал available_payment_method_groups, форма показывает ошибку об отсутствии методов.Если этого недостаточно — официальная документация: https://help.prodamus.ru/payform/tekhnicheskaya-dokumentaciya/webhook-ob-oplate Вся интеграция одним документом: https://mcp-everything.ru/integrations/prodamus.md