Prodamus
  • О Prodamus
  • Payform
    • Уточняющее письмо от ФНС по ФЗ-54: что изменилось и как это влияет на наших клиентов
    • Начало работы с Prodamus
      • Как устроен Prodamus
      • Как подключить Prodamus
      • Какие методы оплаты поддерживает Prodamus
      • Как самозанятым интегрировать Prodamus с приложением «Мой налог»
        • Как в настройках платёжной ссылки указать тип плательщика
      • Как принимать оплату с карт иностранных государств
      • Как школам из Казахстана подключить онлайн-кассу к платёжной странице
      • Как подключить к платёжной странице онлайн-кассу «Атол»
    • Настройка платёжной страницы
      • Как начать приём платежей за 5 минут
      • Как авторизоваться на платёжной странице
      • Как восстановить логин и пароль от платёжной страницы
      • Как указать контактные данные на платёжной странице
      • Какие поля платёжной страницы можно скрыть, отобразить и переименовать
      • Как изменить стиль платёжной страницы и добавить на неё логотип компании
      • Как разместить оферту на платёжной странице
      • Как поменять реквизиты платёжной страницы
      • Как изменить режим вывода средств
      • Как отключить плательщику возможность изменять данные заказа
      • Как провести тестовую оплату
      • Как настроить переадресацию после успешной или неудавшейся оплаты
      • Как создать промокод для платёжной страницы
      • Как отключить пробитие чека полного расчёта через кассу Prodamus
      • Как отредактировать платёжную ссылку
    • Приём оплаты
      • Как создать общую платёжную ссылку
      • Как создать персональную платёжную ссылку
      • Как создать партнёрскую платёжную ссылку
        • Как просмотреть продажи от партнеров
      • Как добавить в платёжную ссылку несколько товаров с разными ставками НДС
      • Как юрлицам на УСН учитывать дополнительный налог при пробитии чеков. Инструкция для школ, чей годовой оборот больше 60 млн ₽
      • Как создать платёжную ссылку со скидкой
      • Как отправить платёжную ссылку клиенту
      • Как установить лимит оплат для платёжной ссылки
      • Как отправить клиенту обучающий материал после оплаты заказа
    • Дополнительные настройки платёжной ссылки
      • Как ограничить срок действия платёжной ссылки
      • Как при создании платёжной ссылки отключить оплату заказа в кредит и в рассрочку
    • Отслеживание оплат
      • Как посмотреть и скачать данные по платежам клиентов
      • Как скачать список неоплаченных заказов
      • Как посмотреть и скачать отчёт о выплатах Prodamus
      • Как вывести размер комиссии Prodamus в «Назначение платежа»
      • Как посмотреть неоплаченные заказы
    • Уведомления при оплате
      • Как устроена отправка уведомлений об оплате
      • Как получать уведомления об оплатах на email
      • Как получать уведомления об оплатах через СМС
      • Как получать уведомления об оплатах на URL-адрес
      • Интервалы уведомлений
    • Возвраты платежей
      • Как в Prodamus устроены возвраты платежей клиентам
      • Как сформировать заявку на возврат
      • Как понять, что возврат произведён
    • Вывод средств
      • Как выводить деньги с платёжного модуля Prodamus по запросу
    • Рекуррентные платежи
      • Как принимать рекуррентные платежи через Prodamus
      • Как подключить рекуррентные платежи через клубную систему Prodamus
      • Как создать и настроить подписки
      • Как создать платёжную ссылку для оплаты подписки
      • Как просмотреть и отредактировать подписки
      • Как просмотреть подписчиков и их платежи по подписке
      • Как отключить клиенту подписку
      • Как отказаться от подписки
      • Как получать уведомления о подписках на email
      • Как получать уведомления о подписках на URL-адрес
      • Как отправлять клиентам уведомления о завершении подписки
      • Как отключить клиентам уведомления о предстоящем списании по подписке
      • Когда приходят уведомления о предстоящем списании за подписку
      • Как изменить размер первого платежа по подписке
    • Интеграции со сторонними сервисами
      • Интеграция ЕО в конструкторы сайтов
        • Как подключить виджет Prodamus к сайту на Taplink
        • Как подключить виджет Prodamus к сайту на Linkrr
        • Как подключить виджет Prodamus к сайту, сделанному в Creatium
        • Как подключить виджет Prodamus к сайту на Tilda
        • Веб-страница
      • CMS
        • 1С-Битрикс
        • Advantshop
        • HostCMS
        • Joomla (JoomShopping)
        • Opencart
        • WordPress
        • VirtualityCMS
        • Виджет и примеры кнопок для сайта
      • CRM
        • «Битрикс24»
        • amoCRM
      • Сервисы для чат-ботов
        • Автопилот
        • ActiveUsers
        • BotHelp
        • BotHelp (рекуррентная оплата)
        • CleverApp
        • LeadConverter
        • LeadTEX
        • MyBotan
        • SaleBot.pro
        • Sambot
        • Senler
        • Smartsender
          • Генерация ссылки на оплату
          • Принимаем данные при удачной оплате
          • Подключаем автоответ для запуска воронки
        • SMMbro
        • TargetHunter.Moderator (Bothunter)
        • WinWinBot
        • Chatforma
        • T-bot
        • Watbot
      • Платформы для онлайн-школ
        • Prodamus.XL
        • АвтоВебОфис
        • АвтоОфис
        • EdproBiz
        • EdproBiz (рекуррентная оплата)
        • Антитренинги
        • Мангустин.Онлайн
        • Bizon365
        • CoreApp
        • Emdesell
        • GOODLY.PRO
        • Skillspace
        • SOHO.LMS
        • School-Master
        • MetaFunnels
        • Livedigital
        • E-AUTOPAY
        • Vakas-tools
        • НБИКС.Маркетплейс
        • Expertam
      • Конструкторы мини-сайтов и лендингов
        • Linkrr
        • Taplink
        • Tilda.cc
        • Creatium
      • Сервисы для автоматизации подписок в телеграм
        • Asay
        • Nemiling
        • Toolsy
      • Приложение и примеры работы для VK
      • Документация для интеграции со сторонними сервисами
        • Где найти url для уведомлений и секретный ключ
        • Документация для самостоятельной интеграции сервисов
      • Техническая документация по автоплатежам
        • Формирование ссылки на оплату
        • Управление клубным функционалом
        • Завершение подписки
        • Уведомления при автосписании
        • Деактивация и повторная активация подписки
        • Параметры URL-уведомления по подписке
        • Коды ошибок
      • Rest API
        • Управление статусами подписки
        • Управление скидкой по подписке
        • Установка даты следующего платежа по подписке
  • Партнёрская программа
    • Как устроена партнёрская программа Prodamus
    • Какие есть ступени партнёрской программы
    • Как продвигать промокод и реферальную ссылку партнёрской программы Prodamus
    • Зачем проверять промоматериалы на актуальность и как не допускать в них фактических ошибок
    • Как участнику партнёрской программы Prodamus подписать договор, отправить отчёт и чек
    • Шаблоны для переписки партнёров с потенциальными клиентами Prodamus
    • Инструкция по маркировке рекламы для партнёров Prodamus
    • Кейсы
      • Партнёр Prodamus рассказал, как в 24 года заработал на двушку без ипотеки
      • Как я зарабатываю на партнёрской программе Prodamus от 500 000 ₽ в месяц
      • Первый партнёр Prodamus рассказал, как он вышел на доход свыше 1 000 000 ₽ в месяц
      • Как мама в декрете увеличила свой доход до 300 000 ₽ в месяц благодаря партнёрской программе
      • «За месяц на 2-ой ступени партнёрки я заработала столько же, сколько за прошлый год»
      • Как IT-специалист досрочно выплачивает ипотеку и делает ремонт благодаря партнёрской программе
      • Работодатели отказались платить мне 100 000 ₽, я подключила партнёрку и теперь зарабатываю 900 000 ₽
      • Спокойно жить на 250 000 ₽ с партнёрки, развивая свой бизнес
      • Как партнёрская программа помогла продюсеру спастись от кассового разрыва и улететь на Мальдивы
      • +100 000 ₽ в месяц к общему доходу с помощью Prodamus: партнёрский кейс технического специалиста
      • Зарабатываю в декрете 200 000 ₽ в месяц благодаря партнёрской программе Prodamus
      • Партнёрка Prodamus сделала мою семью финансово независимой
      • Как благодаря партнёрской программе Prodamus начинающий предприниматель открыл свой бизнес
      • Рекомендую продукт, который искренне нравится, и зарабатываю до 300 000 ₽ месяц без усилий
      • Как я увеличила свой доход с 30 000 ₽ до 300 000 ₽ в месяц с помощью партнёрской программы Prodamus
      • Благодаря партнёрке Prodamus я заработал 1,1 млн ₽ за последний год
      • Заработала 300 000 ₽ на партнёрской программе Prodamus за год и открыла свою школу
      • Ежемесячно получаю от Prodamus больше, чем зарабатывала на прежней работе
  • Кейсы
    • Ханна Изотова: провели запуск через Prodamus — платежи не прошли всего у 1-2% клиентов
    • Кирилл Смольников: увеличил конверсию в продление подписки с 15 до 48%, а оборот — на 160%
    • Психолог Мария Мугачева: «Увеличила средний чек в 16 раз и запустила наставничество на 80 000 ₽»
    • Маркетолог-эксперт Юлия Ветрова: увеличила конверсию в оплату на 60% и принимаю платежи от 80 000 ₽
    • Создала новый инфопродукт и увеличила средний чек в 6 раз с помощью платёжного виджета Prodamus
    • Как автор языковых курсов без команды зарабатывает 250 000 ₽ в месяц с помощью Prodamus
    • Тренер по йоге переехала из Самары на Бали и продаёт онлайн-курсы по всему СНГ с помощью Prodamus
    • Как казахстанец принимает платежи из России на сумму 2 млн ₽ в месяц. Кейс антипсихолога
    • Как создатель онлайн-школы увеличила доход на 354% с помощью рассрочек от Prodamus
    • Как я увеличила выручку с 200 000 ₽ до 3 млн ₽ и средний чек в 2,5 раза с помощью Prodamus.Pay
    • «После подключения Prodamus я не переживаю за продажи»
    • Увеличила конверсию в оплату на 87% благодаря Prodamus.Pay
    • Подключила Prodamus.Pay и увеличила выручку в 2 раза
    • Заработал более 420 000 ₽ за один день продаж при помощи трёх сервисов экосистемы Prodamus
    • Как мама в декрете зарабатывает 300 000 ₽ в месяц благодаря Prodamus.Pay
    • Кейсы Prodamus.XL
      • Переехали на Prodamus.XL и запустили курсы по астрологии более чем на 1 млн ₽
      • Переехала на Prodamus.XL и экономлю более 200 000 ₽ в год
      • Переехал на Prodamus.XL и экономлю более 500 000 ₽ в год
      • Как Prodamus.XL помогает мне зарабатывать 4,5 млн ₽ в год и масштабировать бизнес
      • За полгода привлёк 346 новых учеников и увеличил доход в два раза благодаря Prodamus.XL
      • Как я увеличила доход в 10 раз за 9 месяцев после переезда на Prodamus.XL
      • Спас удалённую базу в 10 000+ клиентов благодаря техподдержке Prodamus.XL
      • Как с помощью Prodamus.XL мы увеличили оборот почти в 2 раза и сократили расходы на команду и сервис
      • Как начинающий эксперт экономит 859 200 ₽ в год на Prodamus.XL
      • Спас удалённую базу в 10 000+ клиентов благодаря техподдержке Prodamus.XL
      • Как заработать 4 млн ₽ на подписках без рекламы
    • Кейсы TeleBoss
      • Провела вебинар с помощью TeleBoss на 2 000 зрителей и перестала переплачивать за Zoom
      • Ушла из Zoom в TeleBoss и увеличила охваты вебинаров на 20%
    • Кейсы Linkrr
      • Создала сотню эффективных страниц без веб-дизайнера с помощью Prodamus.Linkrr
      • Экономлю клиентам время и деньги благодаря Prodamus.Linkrr
  • Оформление рассрочек
    • Как оформить рассрочку от Сбербанка
    • Как оформить рассрочку от «Хоум Банка»
    • Как оформить рассрочку от «Т-Банка»
      • Добавили возможность увеличить срок рассрочки Т-Банка​, если покупателю пришёл отказ
    • Как оформить рассрочку от «ОТП Банка»
  • Блог «Знание—деньги»
    • Какую платёжную систему выбрать для онлайн-школы
    • Как принимать деньги на сайте онлайн-школы
    • Система быстрых платежей для бизнеса: 9 главных вопросов
    • Как самозанятому принимать платежи в 2024 году
    • Топ платёжных систем для интернет-магазина
    • Платёжные системы: какие бывают, какую выбрать в России
    • Оферта для онлайн-школ и экспертов: как правильно составить и где разместить
  • Обновления Prodamus.Pay
    • Добавили возможность проводить оплаты по реквизитам через QR-код
    • Обновили интеграцию Prodamus с «1C-Битрикс»
    • Добавили в личный кабинет новый раздел, где можно просматривать неоплаченные заказы
    • Добавили возможность изменять размер первого платежа по подписке
    • Добавили возможность редактировать платёжные ссылки
    • Добавили возможность выводить деньги с платёжного модуля Prodamus по запросу пользователей
    • Добавили возможность увеличить срок рассрочки Т-Банка​, если покупателю пришёл отказ
  • Обновления Prodamus.XL
    • Обновления Prodamus.XL за июль-август 2024 года
  • Prodamus.Kassa
    • Описание разделов личного кабинета Prodamus.Kassa
  • Prodamus. Частями
    • Как оформить заказ с помощью сервиса «Prodamus Частями»
    • Как внести плановый платёж и досрочно закрыть долг
    • Что будет, если вовремя не оплатить покупку в сервисе «Prodamus Частями»
    • Как оформить возврат за заказ, оплаченный при помощи сервиса «Prodamus Частями»
  • Мы в Соц Сетях
    • Группа в VK
    • Канал Youtube
    • Instagram
    • Facebook
    • Одноклассники
    • Prodamus.ru
    • Payform.ru
  • Промокоды Продамус на скидку на подключение сервисов Prodamus для самозанятых, ИП и юридических лиц
Powered by GitBook
On this page
  • Формируем запрос
  • Параметры, которые вы можете передать в запросе
  • Ссылка на оплату
  • При настройке самостоятельной интеграции
  • Пример программного кода формирования ссылки для демо-формы:
  • Как принять Уведомление об успешной оплате
  • Проверка успешной интеграции
  1. Payform
  2. Интеграции со сторонними сервисами
  3. Документация для интеграции со сторонними сервисами

Документация для самостоятельной интеграции сервисов

В данный раздел поможет интегрировать Продамус с системами, для которых нет официальной интеграции. А так же поможет разработчикам, прописать дополнительные параметры для уже существующих интеграций

PreviousГде найти url для уведомлений и секретный ключNextТехническая документация по автоплатежам

Last updated 2 months ago

Формируем запрос

Для формирования платежной ссылки вам необходимо отправить GET или POST запрос себе на платежную страницу

Где прописать URL-адрес и скопировать секретный ключ подробно в разделе

В зависимости от сервиса, с которым вы интегрируетесь, вы можете прописывать параметры платежной страницы отдельно, передавая их программным кодом или использую стандартные команды вашего сервиса (например Автопилот или SmartSender) либо в самой ссылке Get-запроса.

Для формирования GET или POST запроса вам потребуется:

ссылка должна быть вида http://название_поддомена.payform.ru/

Например https://demo.payform.ru/

Параметры, которые вы можете передать в запросе

Обязательные параметры при формировании ссылки

Параметр

Тип

Описание

do

строка

products

массив

sys

строка

код системы интернет-магазина (необходимо согласовать с поддержкой Продамуса)

Возможные значения параметра do

  1. "link" - возвращает ссылку, которую отправляем пользователю для самостоятельного перехода на страницу оплаты

  2. "pay" - отправляет покупателя сразу на оплату. Используется для интернет-магазинов действие "Оплата"

Параметры массива products

Параметр

Тип

Описание

Обязательный

name

строка

наименование товара

ДА

price

число

цена товара

ДА

quantity

целое число

количество товара

ДА

sku

строка

id товара в системе интернет-магазин

НЕТ

Чтобы прописать параметры массива: наименование, цена и количество товара, необходимо обратиться в глубь массива 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_email

строка

e-mail адрес клиента

customer_extra

строка

описание заказа (Поле дополнительные данные)

ref

строка

идентификатор партнера (ПРОМОКОД)

paid_content

строка

платный контент

link_expired

строка

срок действия ссылки в формате "гггг-мм-дд чч:мм"

payment_method

строка

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

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

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

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

ACkztjp - оплата картой всех стран мира, кроме РФ

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

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

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

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

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

QW - Qiwi wallet

GP - платежный терминал

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

installment - Частями от Продамус

installment_5_21 - Частями от Продамус на 3 месяца

installment_6_28 - Частями от Продамус на 6 месяцев

installment_10_28 - Частями от Продамус на 10 месяцев

installment_12_28 - Частями от Продамус на 12 месяцев

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 месяцев

installment_0_0_3 - Рассрочка от Тинькофф на 3 месяца

installment_0_0_4 - Рассрочка от Тинькофф на 4 месяца

installment_0_0_6 - Рассрочка от Тинькофф на 6 месяцев

installment_0_0_10 - Рассрочка от Тинькофф на 10 месяцев

installment_0_0_12 - Рассрочка от Тинькофф на 12 месяцев

installment_0_0_18 - Рассрочка от Тинькофф на 18 месяцев

installment_0_0_24 - Рассрочка от Тинькофф на 24 месяца

installment_0_0_36 - Рассрочка от Тинькофф на 36 месяцев

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 месяцев freedomfinance_installment_0_0_3 - Рассрочка для граждан Казахстана на 3 месяца freedomfinance_installment_0_0_6 - Рассрочка для граждан Казахстана на 6 месяцев freedomfinance_installment_0_0_12 - Рассрочка для граждан Казахстана на 12 месяцев freedomfinance_installment_0_0_24 - Рассрочка для граждан Казахстана на 24 месяца monetaworld - Карты банков мира, кроме РФ sbrf_bnpl - Частями от Сбер

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

Параметр 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

<?php

header('Content-type:text/plain;charset=utf-8');

require_once __DIR__ . '/Hmac.php';

$linktoform = 'https://demo.payform.ru/';

// Секретный ключ. Можно найти на странице настроек, 
// в личном кабинете платежной формы.
$secret_key = '2y2aw4oknnke80bp1a8fniwuuq7tdkwmmuq7vwi4nzbr8z1182ftbn6p8mhw3bhz';

$data = [
	// хххх - номер заказ в системе интернет-магазина
	'order_id' => хххх,

	// +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%;
			  //    12 - НДС чека по ставке 7%.
			  '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));

Как принять Уведомление об успешной оплате

Проверка подписи необходима в целях безопасности, иначе, технически, веб-хук может отправить кто угодно. Подпись формируется на основе данных запроса и секретного ключа вашей платежной страницы.

Для проверки подписи, необходимо вызвать метод 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());
}

Проверка успешной интеграции

Для тестирования используйте свою платежную странницу, в исключительном случае вы можете воспользоваться данными нашей демо-страницы, для этого необходимо запросить доступ у менеджеров

по телефону: 8 (495) 150-08-71

После всех настроек обязательно проверьте формирование ссылки. Пройдите по ней, проверьте все ли параметры прописаны корректно

После завершения тестирования интеграции с Вашей стороны, просим написать в поддержку Продамуса. Мы осуществим проверку со своей стороны.

А так же разместим соответствующую информацию на своих сайтах и группах в соцсетях

товары ()

номер телефона клиента (обязательный к заполнению при оплате, )

То есть вы можете сформировать ссылку на оплату не указывая номер телефона покупателя, он заполнит это поле самостоятельно. В этом случае покупателю откроется ссылка в предварительном окне оплаты, где система попросит заполнить поле номер телефона (рис. 1) и после его заполнения и нажатия кнопки "Оплатить" ваш плательщик уже перейдет на страницу с выбором метода оплаты и сможет оплатить товар (рис.2)

Если вы хотите исключить дополнительный шаг при покупке, то можете прописать параметр customer_phone уже при формировании ссылки на оплату, тогда ваш покупатель будет переходить сразу на шаг выбора удобного ему метода оплаты (рис.2)

Массив data содержит данные для формирования платежной ссылки. Параметр signature - подпись запроса. Формируется на основе данных формы и секретного ключа. Для формирования подписи запроса можно воспользоваться готовой библиотекой Hmac

При настройке принятия веб-хука с уведомлением об успешной оплате на вашем сервисе (пример ), вам необходимо проверить подпись пришедшего запроса. Так скажем, убедиться, что Веб-Хук пришел именно от Продамуса.

в личные сообщения группы в VK:

на электронную почту:

в Телеграм-канале:

Информация носит исключительно справочный характер и не является офертой. С актуальной редакцией оферты и тарифами Вы можете ознакомиться в разделе "".

⬇️
⬇️
⬇️
⤵️
уведомления об оплате здесь
https://vk.com/im?sel=-11636316
sales@prodamus.ru
https://t.me/prodamus_bot
Документы
URL-адрес и секретный ключ
Параметры для запросов
"Где найти url для уведомлений и секретный ключ"
Ссылка на оплату
Пример программного кода формирования ссылки на оплату
Проверка успешной интеграции
может принимать значения
перейти к описанию параметров массива products
подробнее о параметре customer_phone
1KB
Hmac.php
Библиотека Hmac.php
651B
Hmac.js.zip
archive
Библиотека Hmac.js
1KB
Hmac.php
Библиотека Hmac
651B
Hmac.js.zip
archive
Библиотека Hmac.js
рис. 1
рис. 2