Документация для самостоятельной интеграции сервисов
В данный раздел поможет интегрировать Продамус с системами, для которых нет официальной интеграции. А так же поможет разработчикам, прописать дополнительные параметры для уже существующих интеграций
Формируем запрос
Для формирования платежной ссылки вам необходимо отправить GET или POST запрос себе на платежную страницу
Где прописать URL-адрес и скопировать секретный ключ подробно в разделе "Где найти url для уведомлений и секретный ключ"
В зависимости от сервиса, с которым вы интегрируетесь, вы можете прописывать параметры платежной страницы отдельно, передавая их программным кодом или использую стандартные команды вашего сервиса (например Автопилот или SmartSender) либо в самой ссылке Get-запроса.
Для формирования GET или POST запроса вам потребуется:
ссылка должна быть вида http://название_поддомена.payform.ru/
Например https://demo.payform.ru/
Параметры, которые вы можете передать в запросе
Обязательные параметры при формировании ссылки
Возможные значения параметра do
do
"link" - возвращает ссылку, которую отправляем пользователю для самостоятельного перехода на страницу оплаты
"pay" - отправляет покупателя сразу на оплату. Используется для интернет-магазинов действие "Оплата"
Параметры массива products
products
Чтобы прописать параметры массива: наименование, цена и количество товара, необходимо обратиться в глубь массива
products Например
products[0]name
для php
Параметры продукта, являются НЕобязательными
Параметры для рекуррентных платежей
Параметры для пользователей Вк, являются НЕобязательными
Параметры передающие данные о юр.статусе плательщика
Общие Необязательные параметры
Параметр customer_phone
customer_phone
Данный параметр является обязательным при оплате покупателем товара на вашей платежной странице, но не является обязательным при формировании ссылки.
Параметры urlReturn и urlSuccess актуальны, например, в тех случаях, когда оплата была инициирована на стороне Вашего интернет-магазина и необходимо чтобы пользователь вернулся обратно. В случае отсутствия данных параметров в запросе, сообщение об успехе или ошибке, после оплаты, будет показано показано на платежной странице системы Продамус.
Если передан параметр subscription, параметр products игнорируется.
Ссылка на оплату
При значении параметра 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
Как принять Уведомление об успешной оплате
При настройке принятия веб-хука с уведомлением об успешной оплате на вашем сервисе (пример уведомления об оплате здесь), вам необходимо проверить подпись пришедшего запроса. Так скажем, убедиться, что Веб-Хук пришел именно от Продамуса.
Проверка подписи необходима в целях безопасности, иначе, технически, веб-хук может отправить кто угодно. Подпись формируется на основе данных запроса и секретного ключа вашей платежной страницы.
Для проверки подписи, необходимо вызвать метод verify класса Hmac, в качестве аргументов передайте данные входящего POST запроса, секретный ключ платежной страницы и подпись из заголовков запроса. Метод сформирует подпись на основе данных запроса и секретного ключа (аргументы 1 и 2) и сравнит его с подписью, которая была передана в запросе (аргумент 3). Если метод вернул false (подписи не совпадают), необходимо вернуть http-код отличный от 200 и прекратить дальнейшую обработку. В случае, если метод вернул true (подписи совпадают), необходимо вернуть http-код 200 и отработать дальнейшие команды на стороне вашего сервиса.
Пример проверки подписи запроса:
Проверка успешной интеграции
Для тестирования используйте свою платежную странницу, в исключительном случае вы можете воспользоваться данными нашей демо-страницы, для этого необходимо запросить доступ у менеджеров
по телефону: 8 (495) 150-08-71
в личные сообщения группы в VK: https://vk.com/im?sel=-11636316
на электронную почту: sales@prodamus.ru
в Телеграм-канале: https://t.me/prodamus_bot
После всех настроек обязательно проверьте формирование ссылки. Пройдите по ней, проверьте все ли параметры прописаны корректно
После завершения тестирования интеграции с Вашей стороны, просим написать в поддержку Продамуса. Мы осуществим проверку со своей стороны.
А так же разместим соответствующую информацию на своих сайтах и группах в соцсетях
Информация носит исключительно справочный характер и не является офертой. С актуальной редакцией оферты и тарифами Вы можете ознакомиться в разделе "Документы".
Last updated