# Документация для самостоятельной интеграции сервисов * [URL-адрес и секретный ключ](https://help.prodamus.ru/payform/integracii/rest-api/url-dlya-uvedomlenii-i-sekretnyi-klyuch) * [Параметры для запросов](https://help.prodamus.ru/payform/integracii/rest-api/instrukcii-dlya-samostoyatelnaya-integracii-servisov#parametry-kotorye-vy-mozhete-peredat-v-zaprose) * [Ссылка на оплату](#formiruem-zapros) * [Пример программного кода формирования ссылки на оплату](#primer-programmnogo-koda-formirovaniya-ssylki-dlya-demo-formy) * [Проверка успешной интеграции](#proverka-uspeshnoi-integracii) ### Формируем запрос Для формирования платежной ссылки вам необходимо отправить GET или POST запрос себе на платежную страницу Где прописать URL-адрес и скопировать секретный ключ подробно в разделе ["Где найти url для уведомлений и секретный ключ"](https://help.prodamus.ru/payform/integracii/rest-api/url-dlya-uvedomlenii-i-sekretnyi-klyuch) В зависимости от сервиса, с которым вы интегрируетесь, вы можете прописывать параметры платежной страницы отдельно, передавая их программным кодом или использую стандартные команды вашего сервиса (*например Автопилот или SmartSender*) либо в самой ссылке Get-запроса. Для формирования GET или POST запроса вам потребуется: * [x] URL-адрес платежной формы в системе Продамус. По сути это адрес из адресной строки вашей платежной страницы > ссылка должна быть вида ; > > *Например * ### Параметры, которые вы можете передать в запросе #### Обязательные параметры при формировании ссылки | Параметр | Тип | Описание | | -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | do | строка | [ может принимать значения](#vozmozhnye-znacheniya-parametra-do) | | products | массив | товары ([перейти к описанию параметров массива `products`](#parametry-massiva-products)) | | sys | строка | Параметр SYS — это код вашей интеграции (**его нужно согласовать с** [**поддержкой Prodamus**](https://max.ru/id1215156909_2_bot)). По нему система определяет интеграцию. У всех клиентов в рамках одной интеграции должен быть один и тот же SYS. | #### Возможные значения параметра `do` 1. "link" - возвращает ссылку, которую отправляем пользователю для самостоятельного перехода на страницу оплаты 2. "pay" - отправляет покупателя сразу на оплату. Используется для интернет-магазинов действие "Оплата" #### Параметры массива `products`
ПараметрЗначениеТипОписаниеОбязательный
Параметр -ТипОписаниеОбязательный
name -строканаименование товараДА
price -числоцена товараДА
quantity -целое числоколичество товараДА
sku -строкаid товара в системе интернет-магазинНЕТ
type
  • course - Доступ к курсу
  • service - Услуга
  • goods - Товар
строкаКатегория товараНЕТ
> Чтобы прописать параметры массива: **наименование, цена и количество товара**, необходимо обратиться в глубь массива `products`\ > `Например` `products[0]name` для php **Параметры продукта, являются НЕобязательными** | Параметр | Тип | Описание | | --------------- | ----- | ---------------------- | | order\_sum | число | сумма заказа | | discount\_value | число | размер скидки в рублях | #### #### Параметры для рекуррентных платежей | Параметр | Тип | Описание | Обязательный | | --------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------: | | subscription | целое число | id подписки | **ДА** | | subscription\_date\_start | строка |

дата начала подписки в формате "гггг-мм-дд чч:мм"

P.S. Если указать дату в прошлом, то старт подписки будет сдвинут на интервал этой подписки.

| нет | | subscription\_demo\_period | целое число | количество дней демо-периода подписки | нет | | subscription\_limit\_autopayments | целое число |

максимальное количество авто-платежей по подписке

если не указано или меньше единицы, значение будет взято из настроек подписного товара

| нет | **Параметры для пользователей Вк, являются НЕобязательными** | Параметр | Тип | Описание | | -------------- | ----------- | ----------------------------- | | vk\_user\_id | целое число | id пользователя в системе Вк | | vk\_user\_name | строка | ФИО пользователя в системе Вк | #### Параметры передающие данные о юр.статусе плательщика | Параметр | Тип | Описание | | -------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | npd\_income\_type | строка |

тип плательщика, с возможными значениями:

FROM\_INDIVIDUAL - физическое лицо

FROM\_LEGAL\_ENTITY - юридическое лицо

FROM\_FOREIGN\_AGENCY - иностранная организация

значение по умолчанию: FROM\_INDIVIDUAL

| | npd\_income\_inn | целое число |

инн плательщика

обязательно, если форма работает в режиме самозанятого и тип плательщика FROM\_LEGAL\_ENTITY

| | npd\_income\_company | строка |

название компании плательщика

обязательно, если форма в режиме самозанятого и тип плательщика FROM\_LEGAL\_ENTITY или FROM\_FOREIGN\_AGENCY

| #### Общие Н**еобязательные параметры** | Параметр | Тип | Описание | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | order\_id | строка | номер заказа в Вашей системе | | customer\_phone | строка | номер телефона клиента (обязательный к заполнению при оплате, [подробнее о параметре `customer_phone`](#parametr-customer_phone)) | | customer\_email | строка | e-mail адрес клиента | | customer\_extra | строка | описание заказа (Поле дополнительные данные) | | ref | строка | идентификатор партнера (ПРОМОКОД) | | paid\_content | строка | платный контент | | link\_expired | строка | срок действия ссылки в формате "дд.мм.гггг чч:мм" | | payment\_method | строка |

метод оплаты, выбранный клиентом, если есть возможность выбора на стороне интернет-магазина, иначе клиент выбирает метод оплаты на стороне платежной формы

доступные значения:

AC - оплата картой, выпущенной в РФ

ACkz - оплата картой Казахстана

ACf - оплата картами стран СНГ, кроме РФ

ACUSDGTL - Оплата в USD картой всех стран, кроме РФ

ACEURGTL - Оплата в EUR картой всех стран, кроме РФ

ACBYNGTL - Оплата в BYN оплата картой Беларуси

ACUSDKB - Оплата в USD Карты банков мира кроме России | |
ACEURKB - Оплата в EUR Карты банков мира кроме России

SBP - Быстрый платёж, без ввода данных карты. Для карт РФ

sbol - Сбербанк онлайн invoice - Оплата по счету

tpay - Оплата через Т-Банк без ввода данных карты

fresh\_installment\_0\_0\_6 — Рассрочка от Фреш Кредит на 6 месяцев
fresh\_installment\_0\_0\_10 — Рассрочка от Фреш Кредит на 10 месяцев
fresh\_installment\_0\_0\_12 — Рассрочка от Фреш Кредит на 12 месяцев
fresh\_installment\_0\_0\_18 — Рассрочка от Фреш Кредит на 18 месяцев
fresh\_installment\_0\_0\_24 — Рассрочка от Фреш Кредит на 24 месяца
fresh\_installment\_0\_0\_36 — Рассрочка от Фреш Кредит на 36 месяцев

dolyame:installment — Оплата долями от Т-банка

proonline\_installment\_rb\_0\_0\_6 — Рассрочка от Про-онлайн в РБ на 6 месяцев
proonline\_installment\_rb\_0\_0\_12 — Рассрочка от Про-онлайн в РБ на 12 месяцев
proonline\_installment\_rb\_0\_0\_18 — Рассрочка от Про-онлайн в РБ на 18 месяцев
proonline\_installment\_rb\_0\_0\_24 — Рассрочка от Про-онлайн в РБ на 24 месяца

proonline\_installment\_kz\_0\_0\_6 — Рассрочка от Про-онлайн в КЗ на 6 месяцев
proonline\_installment\_kz\_0\_0\_12 — Рассрочка от Про-онлайн в КЗ на 12 месяцев
proonline\_installment\_kz\_0\_0\_18 — Рассрочка от Про-онлайн в КЗ на 18 месяцев
proonline\_installment\_kz\_0\_0\_24 — Рассрочка от Про-онлайн в КЗ на 24 месяца

proonline\_installment\_kg\_0\_0\_6 — Рассрочка от Про-онлайн в Кыргызстане на 6 месяцев
proonline\_installment\_kg\_0\_0\_12 — Рассрочка от Про-онлайн в Кыргызстане на 12 месяцев
proonline\_installment\_kg\_0\_0\_18 — Рассрочка от Про-онлайн в Кыргызстане на 18 месяцев
proonline\_installment\_kg\_0\_0\_24 — Рассрочка от Про-онлайн в Кыргызстане на 24 месяца

installment\_4\_14:v3.0 - Частями 3.0 от Продамус на 1,5 месяца

installment\_5\_21:v3.0 - Частями 3.0 от Продамус на 3 месяца
installment\_6\_28:v3.0 - Частями 3.0 от Продамус на 6 месяцев
installment\_10\_28:v3.0 - Частями 3.0 от Продамус на 10 месяцев
installment\_12\_28:v3.0 - Частями 3.0 от Продамус на 12 месяцев
yandex\_installment\_0\_0\_2 - Яндекс Сплит на 2 месяца | | | |
yandex\_installment\_0\_0\_4 - Яндекс Сплит на 4 месяца | | | |
yandex\_installment\_0\_0\_6 - Яндекс Сплит на 6 месяцев | | | |
yandex\_installment\_0\_0\_12 - Яндекс Сплит на 12 и 24 месяца

TINKOFF\_API\_SUBSIDIZED\_HIGH\_INSTALLMENT\_0\_0\_3 - рассрочка Т-банка на 3 месяца TINKOFF\_API\_SUBSIDIZED\_HIGH\_INSTALLMENT\_0\_0\_4 - рассрочка Т-банка на 4 месяца TINKOFF\_API\_SUBSIDIZED\_HIGH\_INSTALLMENT\_0\_0\_6 - рассрочка Т-банка на 6 месяцев TINKOFF\_API\_SUBSIDIZED\_HIGH\_INSTALLMENT\_0\_0\_10 - рассрочка Т-банка на 10 месяцев

TINKOFF\_API\_SUBSIDIZED\_HIGH\_INSTALLMENT\_0\_0\_12 - рассрочка Т-банка на 12 месяцев TINKOFF\_API\_SUBSIDIZED\_HIGH\_INSTALLMENT\_0\_0\_18 - рассрочка Т-банка на 18 месяцев TINKOFF\_API\_SUBSIDIZED\_HIGH\_INSTALLMENT\_0\_0\_24 - рассрочка Т-банка на 24 месяца TINKOFF\_API\_SUBSIDIZED\_HIGH\_INSTALLMENT\_0\_0\_36 - рассрочка Т-банка на 36 месяцев

credit - Кредит от Тинькофф
vsegdada\_installment\_0\_0\_3 - Рассрочка ВсегдаДа на 3 месяца без переплаты!

vsegdada\_installment\_0\_0\_4 - Рассрочка ВсегдаДа на 4 месяца без переплаты! (не работает с available\_payment\_methods)

vsegdada\_installment\_0\_0\_6 - Рассрочка от ВсегдаДа на 6 месяцев без переплаты!

vsegdada\_installment\_0\_0\_10 - Рассрочка от ВсегдаДа на 10 месяцев без переплаты

vsegdada\_installment\_0\_0\_12 - Рассрочка от ВсегдаДа на 12 месяцев без переплаты

vsegdada\_installment\_0\_0\_18 - Рассрочка от ВсегдаДа на 18 месяцев без переплаты

vsegdada\_installment\_0\_0\_24 - Рассрочка от ВсегдаДа на 24 месяца без переплаты!

vsegdada\_installment\_0\_0\_36 - Рассрочка от ВсегдаДа на 36 месяцев без переплаты!

sbrf\_installment\_0\_0\_6 - Рассрочка от СберБанка на 6 месяцев

sbrf\_installment\_0\_0\_10 - Рассрочка от СберБанка на 10 месяцев

sbrf\_installment\_0\_0\_12 - Рассрочка от СберБанка на 12 месяцев

sbrf\_installment\_0\_0\_18 - Рассрочка от СберБанка на 18 месяца
otp\_installment\_0\_0\_3 - Рассрочка «ОТП Банка» на 3 месяца
otp\_installment\_0\_0\_6 - Рассрочка «ОТП Банка» на 6 месяцев
otp\_installment\_0\_0\_10 - Рассрочка «ОТП Банка» на 10 месяцев
otp\_installment\_0\_0\_12 - Рассрочка «ОТП Банка» на 12 месяцев
otp\_installment\_0\_0\_18 - Рассрочка «ОТП Банка» на 18 месяцев

otp\_installment\_0\_0\_24 - Рассрочка «ОТП Банка» на 24 месяцев

otp\_installment\_0\_0\_36 - Рассрочка «ОТП Банка» на 36 месяцев
monetaworld - Карты банков мира, кроме РФ
sbrf\_bnpl - Частями от Сбер
wbpay - WB кошелек | | | |
yandexpay - Yandex Pay

| | | | available\_payment\_methods | строка | Список доступных методов оплаты. Список возможных значений аналогичен параметру **payment\_method.** Допускается передача нескольких значений, разделяя их вертикальной чертой. Если **available\_payment\_methods** передан, то список доступных методов оплаты будет ограничен переданными кодами. Если в результате фильтрации не остается ни одного метода оплаты, данный параметр будет проигнорирован и выведется полный список доступных методов. | | urlReturn | строка | URL-адрес для возврата пользователя без оплаты | | urlSuccess | строка | URL-адрес для возврата пользователя при успешной оплате | | urlNotification | строка |

служебный URL-адрес для уведомления интернет-магазина о поступлении оплаты по заказу

в случае успешной обработки запроса, должен вернуть ответ с кодом 200
P.S. Для того, чтобы система учла этот параметр, также должен быть передан параметр sys

| | \_param\_хххх | строка | произвольный сквозной параметр, где хххх - имя вашего произвольного параметра | | utm\_хххх | строка |

сквозной параметр в виде utm-метки, где хххх - имя вашей метки

Например: utm\_source

| | installments\_disabled | целое число |

отключение рассрочки

если передан и не 0, методы оплаты связанные с рассрочкой будут недоступны для выбора при оплате

| | demoFlow | строка |

Параметр для проверки негативного сценария с отказом по рассрочке. ❗Работает только в демо-режиме❗ Доступное значение:

reject

| | demo\_mode | целое число | Если передано значение 1, то платеж пройдет в демо-режиме | | type | строка | Если передано значение json, то ответ от Продамуса придет в формате json | | callbackType | строка | Если передано значение json, то веб-хуки от Продамуса будут приходить в формате json | | currency | строка |

Валюта платежа. Возможные значения:

rub

usd

eur
kzt
P.S. Параметр должен быть в нижнем регистре.

| | payments\_limit | целое число | Лимит оплат по сформированной ссылке | | acquiring | строка |

Эквайринг.
Возможные значения:
sbrf
moneta

qiwi

xpay

xpaykz

| {% hint style="info" %} * Переход пользователя по **urlSuccess** не является подтверждением факта оплаты; * **urlSuccess** используется только для пользовательского сценария возврата при успешной оплате; * Подтверждением оплаты считается только webhook (**urlNotification**) с валидной подписью. {% endhint %} #### **Параметр `customer_phone`** Данный параметр является обязательным при оплате покупателем товара на вашей платежной странице, но не является обязательным при формировании ссылки. То есть вы можете сформировать ссылку на оплату не указывая номер телефона покупателя, он заполнит это поле самостоятельно. В этом случае покупателю откроется ссылка в предварительном окне оплаты, где система попросит заполнить поле номер телефона (рис. 1:arrow\_down:) и после его заполнения и нажатия кнопки "Оплатить" ваш плательщик уже перейдет на страницу с выбором метода оплаты и сможет оплатить товар (рис.2:arrow\_down:) Если вы хотите исключить дополнительный шаг при покупке, то можете прописать параметр **`customer_phone`** уже при формировании ссылки на оплату, тогда ваш покупатель будет переходить сразу на шаг выбора удобного ему метода оплаты (рис.2:arrow\_down:) ![рис. 1](https://4061190562-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M5pHt5axogA0zyX7V6_%2F-MOAh3a8aay-oGFeuuCi%2F-MOBCORlZd5OMCjUNG8u%2Fimage.png?alt=media\&token=8061c732-7494-4655-a863-b623ea449014) ![рис. 2](https://4061190562-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M5pHt5axogA0zyX7V6_%2F-MOAh3a8aay-oGFeuuCi%2F-MOBD9G-Hs34ExrJDrMF%2Fimage.png?alt=media\&token=719ef3cb-9bf9-4cc3-87b0-e0e164c0af41) {% hint style="success" %} Параметры urlReturn и urlSuccess актуальны, например, в тех случаях, когда оплата была инициирована на стороне Вашего интернет-магазина и необходимо чтобы пользователь вернулся обратно. В случае отсутствия данных параметров в запросе, сообщение об успехе или ошибке, после оплаты, будет показано показано на платежной странице системы Продамус. {% endhint %} {% hint style="danger" %} Если передан параметр subscription, параметр products игнорируется. {% endhint %} ### Ссылка на оплату При значении параметра `do`=link ссылка возвращается в текстовом формате вида `https://payform.ru/u8zDE/` Именно ее вам необходимо передать клиенту по средствам возможности вашего бота при помощи сообщения в мессенджере или через сторонние сервисы-рассыльщики Так же есть возможность прописать развернутую ссылку с прописанными необходимыми в ней параметрами > *Пример ссылки с запросом и прописанными в ней параметрами:* > > `https://demo.payform.ru/?order_id=test&customer_phone=79998887755&products[0][price]=2000&products[0][quantity]=1&products[0][name]=Обучающие материалы&customer_extra=Полная оплата курса&do=pay` ### При настройке самостоятельной интеграции Чтобы сформировать Webhook на стороне вашего сервиса для передачи данных об плате, вам необходимо добавить программный код на вашем сайте ### ### Пример программного кода формирования ссылки для демо-формы: В данном примере используется платежная страница демо-формы: `https://demo.payform.ru` Секретный ключ демо-формы: `2y2aw4oknnke80bp1a8fniwuuq7tdkwmmuq7vwi4nzbr8z1182ftbn6p8mhw3bhz` ``` хххх, // +7хххххххххх - мобильный телефон клиента 'customer_phone' => '+7хххххххххх', // ИМЯ@prodamus.ru - e-mail адрес клиента 'customer_email' => 'ИМЯ@prodamus.ru', // перечень товаров заказа 'products' => [ [ // id товара в системе интернет-магазина // (не обязательно) - при необходимоти прописать 'sku' => ХХХХХ, // название товара - необходимо прописать название вашего товара // (обязательный параметр) 'name' => 'товар 1', // цена за единицу товара, 123 - значение, которое нужно прописать // (обязательный параметр) 'price' => '123', // количество товара, х - значение, которое нужно прописать // (обязательный параметр) 'quantity' => 'Х', // данные о налоге // (не обязательно, если не указано будет взято из настроек Магазина // на стороне системы) 'tax' => [ // ставка НДС, с возможными значениями (при необходимоти заменить): // 0 – без НДС; // 1 – НДС по ставке 0%; // 2 – НДС чека по ставке 10%; // 4 – НДС чека по расчетной ставке 10/110; // 6 - НДС чека по ставке 20%; // 7 - НДС чека по расчетной ставке 20/120; // 10 - НДС чека по ставке 5%; // 11 - НДС чека по расчетной ставке 5/105; // 12 - НДС чека по ставке 7%; // 13 - НДС чека по расчетной ставке 7/107; // 14 - НДС по ставке 22%; // 15 - НДС чека по расчетной ставке 22/122. 'tax_type' => 0, // (не обязательно) сумма налога, хх - при необходимости заменить 'tax_sum' => хх, ], // Тип оплаты, с возможными значениями (при необходимости заменить): // 1 - полная предварительная оплата до момента передачи предмета расчёта; // 2 - частичная предварительная оплата до момента передачи // предмета расчёта; // 3 - аванс; // 4 - полная оплата в момент передачи предмета расчёта; // 5 - частичная оплата предмета расчёта в момент его передачи // с последующей оплатой в кредит; // 6 - передача предмета расчёта без его оплаты в момент // его передачи с последующей оплатой в кредит; // 7 - оплата предмета расчёта после его передачи с оплатой в кредит. // (не обязательно, если не указано будет взято из настроек // Магазина на стороне системы) 'paymentMethod' => х, // Тип оплачиваемой позиции, с возможными // значениями (при необходимости заменить): // 1 - товар; // 2 - подакцизный товар; // 3 - работа; // 4 - услуга; // 5 - ставка азартной игры; // 6 - выигрыш азартной игры; // 7 - лотерейный билет; // 8 - выигрыш лотереи; // 9 - предоставление РИД; // 10 - платёж; // 11 - агентское вознаграждение; // 12 - составной предмет расчёта; // 13 - иной предмет расчёта. // (не обязательно, если не указано будет взято из настроек Магазина на стороне системы) 'paymentObject' => х, ], ], // id подписки (при необходимости прописать) // актуально и обязательно только для рекуррентных платежей, // передается вместо параметра products 'subscription' => 123, // вк id пользователя (при необходимости прописать) 'vk_user_id' => 123, // фио пользователя в ВК (при необходимости прописать) 'vk_user_name' => 'Фамилия Имя Отчество', // дополнительные данные 'customer_extra' => 'Текст, который отобразится в поле "Дополнительные данные"', // для интернет-магазинов доступно только действие "Оплата" 'do' => 'pay', // url-адрес для возврата пользователя без оплаты // (при необходимости прописать свой адрес) 'urlReturn' => 'https://demo.payform.ru/demo-return', // url-адрес для возврата пользователя при успешной оплате // (при необходимости прописать свой адрес) 'urlSuccess' => 'https://demo.payform.ru/demo-success', // служебный url-адрес для уведомления интернет-магазина // о поступлении оплаты по заказу // пока реализован только для Advantshop, // формат данных настроен под систему интернет-магазина // (при необходимости прописать свой адрес) 'urlNotification' => 'https://demo.payform.ru/demo-notification', // код системы интернет-магазина, запросить у поддержки, // для самописных систем можно оставлять пустым полем // (при необходимости прописать свой код) 'sys' => 'код системы', // метод оплаты, выбранный клиентом // если есть возможность выбора на стороне интернет-магазина, // иначе клиент выбирает метод оплаты на стороне платежной формы // варианты (при необходимости прописать значение): // AC - банковская карта // PC - Яндекс.Деньги // QW - Qiwi Wallet // WM - Webmoney // GP - платежный терминал 'payment_method' => 'ХХ', // сумма скидки на заказ // указывается только в том случае, если скидка // не прменена к товарным позициям на стороне интернет-магазина // алгоритм распределения скидки по товарам // настраивается на стороне пейформы 'discount_value' => 0.00, // тип плательщика, с возможными значениями: // FROM_INDIVIDUAL - Физическое лицо // FROM_LEGAL_ENTITY - Юридическое лицо // FROM_FOREIGN_AGENCY - Иностранная организация // (не обязательно. если форма работает в режиме самозанятого // значение по умолчанию: FROM_INDIVIDUAL) 'npd_income_type' => 'FROM_INDIVIDUAL', // инн плательщика (при необходимости прописат) // (обязательно, если форма в режиме самозанятого // и тип плательщика FROM_LEGAL_ENTITY) 'npd_income_inn' => 1234567890, // название компании плательщика (при необходимости прописать название) // (обязательно, если форма в режиме самозанятого // и тип плательщика FROM_LEGAL_ENTITY или FROM_FOREIGN_AGENCY) 'npd_income_company' => 'Название компании плательщика', // срок действия ссылки в формате: дд.мм.гггг чч:мм или гггг-мм-дд чч:мм // при необходимости добавить дату // (не обязательно, по умолчанию срок действия ссылки не ограничен) 'link_expired' => 'дд.мм.гггг чч:мм', // дата начала подписки в формате: дд.мм.гггг чч:мм или гггг-мм-дд чч:мм // при необходимости добавить дату // (не обязательно, актуально только для рекуррентных платежей, // по умолчанию текущая дата/время) 'subscription_date_start' => 'дд.мм.гггг чч:мм', // текст который будет показан пользователю после совершения оплаты // (не обязательно) 'paid_content' => 'Текс сообщения' ]; $data['signature'] = Hmac::create($data, $secret_key); $link = sprintf('%s?%s', $linktoform, http_build_query($data)); ``` Массив **`data`** содержит данные для формирования платежной ссылки. Параметр **`signature`** - подпись запроса**.** Формируется на основе данных формы и секретного ключа. Для формирования подписи запроса можно воспользоваться готовой библиотекой Hmac :arrow\_heading\_down: {% file src="" %} Библиотека Hmac.php {% endfile %} {% file src="" %} Библиотека Hmac.js {% endfile %} **Алгоритм формирования подписи:** 1. Возьмите содержимое запроса и приведите все значения к строкам 2. Далее отсортируйте все содержимое по ключам в алфавитном порядке, в том числе вглубь 3. Переведите массив в json строку 4. В json строке экранируйте / 5. Подпишите получившуюся json строку через sha256 секретным ключом со страницы. **Поведение демо-платежей на уровне подписи:** * при демо-платежах используется намеренно отличающаяся подпись (secret key с суффиксом demo); * такая подпись не должна проходить проверку как боевая; * это сделано специально, чтобы исключить принятие демо-платежей за реальные и предотвратить выдачу платного контента. {% hint style="info" %} **Дополнительно:** В системе предусмотрены два сценария демо-режима: * демо-режим, который мерчант может включить самостоятельно в настройках платежной страницы, предназначен для тестирования пользовательского сценария и не влияет на подпись запросов * защитная логика с изменением подписи применяется только при отключении боевого режима платежной страницы **на стороне системы** {% endhint %} ### Как принять Уведомление об успешной оплате При настройке принятия веб-хука с уведомлением об успешной оплате на вашем сервисе (пример [уведомления об оплате здесь](https://help.prodamus.ru/payform/uvedomleniya)), вам необходимо проверить подпись пришедшего запроса. Так скажем, убедиться, что Веб-Хук пришел именно от Продамуса. Проверка подписи необходима в целях безопасности, иначе, технически, веб-хук может отправить кто угодно. Подпись формируется на основе данных запроса и секретного ключа вашей платежной страницы. Для проверки подписи, необходимо вызвать метод **verify** класса **Hmac**, в качестве аргументов передайте данные входящего POST запроса, секретный ключ платежной страницы и подпись из заголовков запроса. Метод сформирует подпись на основе данных запроса и секретного ключа (аргументы 1 и 2) и сравнит его с подписью, которая была передана в запросе (аргумент 3). Если метод вернул **false** (подписи не совпадают), необходимо вернуть http-код отличный от 200 и прекратить дальнейшую обработку. В случае, если метод вернул **true** (подписи совпадают), необходимо вернуть http-код 200 и отработать дальнейшие команды на стороне вашего сервиса. Пример проверки подписи запроса: ``` require_once 'Hmac.php'; $secret_key = 'ваш_секретный_ключ'; $headers = apache_request_headers(); try { if ( empty($_POST) ) { throw new Exception('$_POST is empty'); } elseif ( empty($headers['Sign']) ) { throw new Exception('signature not found'); } elseif ( !Hmac::verify($_POST, $secret_key, $headers['Sign']) ) { throw new Exception('signature incorrect'); } http_response_code(200); echo 'success'; } catch (Exception $e) { http_response_code($e->getCode() ? $e->getCode() : 400); printf('error: %s', $e->getMessage()); } ``` {% file src="" %} Библиотека Hmac {% endfile %} {% file src="" %} Библиотека Hmac.js {% endfile %} ### Проверка успешной интеграции Для тестирования используйте свою платежную странницу, в исключительном случае вы можете воспользоваться данными нашей демо-страницы, для этого необходимо запросить доступ у менеджеров {% hint style="success" %} по телефону: `8 (495) 150-08-71` в личные сообщения группы в VK: на электронную почту: в боте в MAX: {% endhint %} {% hint style="info" %} После всех настроек **обязательно** проверьте формирование ссылки. Пройдите по ней, проверьте все ли параметры прописаны корректно {% endhint %} {% hint style="info" %} Информация носит исключительно справочный характер и не является офертой. С актуальной редакцией оферты и тарифами Вы можете ознакомиться в разделе "[Документы](https://prodamus.ru/documents)". {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.prodamus.ru/payform/integracii/rest-api/instrukcii-dlya-samostoyatelnaya-integracii-servisov.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.