# Prodamus: GET /?do=link — Создать платёжную ссылку

Endpoint возвращает ссылку при `do=link` или сразу открывает форму при `do=pay`. Запрос также можно отправить методом POST с телом `application/x-www-form-urlencoded` или `multipart/form-data`.

Пример ответа при `do=link`:

Документация: https://help.prodamus.ru/payform/tekhnicheskaya-dokumentaciya/sozdanie-platezhnoy-ssylki#запрос-на-создание-ссылки-/-переход-к-оплате

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `do` | query | string | да | link — вернуть ссылку; pay — перейти к оплате |
| `products` | query | array | нет | Корзина; без неё клиент заполняет товар на странице |
| `products[i].name` | query | string | да | Наименование переданной позиции |
| `products[i].price` | query | number | да | Цена за единицу переданной позиции |
| `products[i].quantity` | query | integer | да | Количество переданной позиции |
| `order_sum` | query | number | нет | Сумма заказа; при do=link без products становится ценой базового товара |
| `order_id` | query | string | нет | Номер заказа в вашей системе |
| `customer_phone` | query | string | нет | Телефон клиента |
| `customer_email` | query | string | нет | Email клиента |
| `sys` | query | string | нет | Код интеграции от поддержки; обязателен для интеграции сервиса |
| `urlNotification` | query | string | нет | URL webhook; учитывается вместе с sys |
| `urlReturn` | query | string | нет | URL возврата без оплаты |
| `urlSuccess` | query | string | нет | URL возврата после успешной оплаты |
| `subscription` | query | integer | нет | ID подписки; если он передан, products игнорируется |
| `demo_mode` | query | integer | нет | Значение 1 включает демо-режим для платежа |
| `callbackType` | query | string | нет | Значение json запрашивает webhook в JSON |
| `signature` | query | string | да | HMAC SHA-256 подпись запроса |

Пример запроса:

```
https://payform.ru/h9brIKu/
```

## Базовые URL

- Платёжная страница и REST API: `https://<subdomain>.payform.ru`
- Скрипт виджета: `https://widget.prodamus.ru/src/init.js`
- Стили виджета: `https://widget.prodamus.ru/src/init.css`
- Отдельного тестового URL в изученных страницах не указано: `demo_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 после экранирования `/`.
- Документация webhook называет базовым форматом `application/x-www-form-urlencoded`, а тестовый чек-лист ожидает `multipart/form-data`; для `callbackType=json` приходит `application/json`. Приёмник должен разбирать фактически выбранный формат до проверки `Sign`.
- Повторная доставка webhook допустима: поле `attempt` может увеличиваться. Обработчик должен быть идемпотентным и отвечать `HTTP 200` только после успешной обработки.
- При `subscription` корзина `products` игнорируется. После деактивации подписки от лица пользователя повторная активация невозможна; нужно оформить подписку заново.
- Оплата по связке не поддерживает тестовый режим. Для первого платежа нужен ключ страницы, для `/rest/payment/do/` — отдельный ключ от поддержки, привязанный к `sys`.
- Синхронный `{"success":true}` от `/rest/payment/do/` подтверждает только инициацию. Итог проверяется по webhook с `payment_init=api`.
- Для `GET /rest/payment-methods/getList` `Timestamp` может быть любой непустой строкой: сервер не проверяет формат или актуальность, срок запроса не ограничен и защиты от повторного воспроизведения нет.
- Тело ответа платёжной формы всегда в UTF-8, но `Content-Type` объявляет `charset=WINDOWS-1251`; это отдельно отмечено в примерах C#.
- Статусы `postMessage` гарантированно доступны для карт РФ, СБП и Сбербанк-онлайн. Для других способов оплаты используй webhook.
- Если `available_payment_methods` отфильтровал все способы, параметр игнорируется и показывается полный список; если пустой результат дал `available_payment_method_groups`, форма показывает ошибку об отсутствии методов.
- В демо-платежах защитное изменение подписи применяется только когда боевой режим формы отключил менеджер Prodamus; пользовательский демо-режим в настройках страницы на подпись не влияет.

## Сценарии с этим методом

- [Принять разовую оплату по ссылке](https://mcp-everything.ru/integrations/prodamus/scenarios/prinyat-razovuyu-oplatu-po-ssylke.md)
- [Надёжно обработать webhook об оплате](https://mcp-everything.ru/integrations/prodamus/scenarios/nadezhno-obrabotat-webhook-ob-oplate.md)
- [Создать и остановить подписку](https://mcp-everything.ru/integrations/prodamus/scenarios/sozdat-i-ostanovit-podpisku.md)
- [Списать деньги по сохранённой карте](https://mcp-everything.ru/integrations/prodamus/scenarios/spisat-dengi-po-sohranennoy-karte.md)

---

Если этого недостаточно — официальная документация: https://help.prodamus.ru/payform/tekhnicheskaya-dokumentaciya/sozdanie-platezhnoy-ssylki#запрос-на-создание-ссылки-/-переход-к-оплате
Вся интеграция одним документом: https://mcp-everything.ru/integrations/prodamus.md