Прием оплаты за цифровые товары и подписки: автовыдача, вебхуки и возвраты
Чтобы принимать оплату за цифровые товары, нужен платёжный шлюз, который сообщает вашему сервису об успешном платеже вебхуком, и код, который после этого выдаёт товар. Paydex даёт СБП, карты РФ и USDT, подписанные вебхуки и возвраты через API, а ИП или ООО для подключения не нужны: мы работаем с обычными физлицами. Ниже схема, настройка автовыдачи, особенности подписок и частые ошибки.
Содержание
- Как устроен приём оплаты за цифровые товары
- Какие способы оплаты подключить для цифровых товаров
- Как настроить автоматическую выдачу товара после оплаты
- Вебхуки оплаты: подпись, повторная доставка и идемпотентность
- Как принимать платежи за подписки и доступ на период
- Как организовать возвраты за цифровые товары
- Как начать принимать оплату с Paydex за один день
- Частые ошибки при приёме платежей за цифровые товары
Как устроен приём оплаты за цифровые товары
Цифровой товар (курс, лицензионный ключ, доступ к закрытому каналу, файл, подписка на сервис) не нужно доставлять. Поэтому покупатель ждёт результата сразу после оплаты. От скорости и надёжности выдачи зависят и конверсия, и число обращений в поддержку.
Базовая схема приёма оплаты за цифровые товары на сайте состоит из пяти шагов:
- Покупатель выбирает товар и нажимает «Оплатить».
- Ваш сервер создаёт платёж через API и получает ссылку на страницу оплаты.
- Покупатель платит по СБП, картой РФ или в USDT.
- Платёжный шлюз отправляет на ваш адрес вебхук со статусом платежа.
- Сервер проверяет подпись, находит заказ и выдаёт товар.
Выдавайте товар по вебхуку, а не по возврату покупателя на страницу «Спасибо». Человек может закрыть вкладку, потерять связь или вернуться раньше, чем придёт подтверждение. Вебхук приходит от шлюза на ваш сервер независимо от действий покупателя.
Для Telegram-ботов схема та же: бот создаёт платёж, присылает ссылку, а после вебхука отправляет файл, ключ или приглашение в закрытый канал.
Три способа запуститься в зависимости от задачи
| Способ | Нужен ли код | Для чего подходит |
|---|---|---|
| Платёжная ссылка | Нет | Разовые продажи, пробный запуск, продажи в чатах с ручной выдачей |
| Страница оплаты без кода | Нет | Небольшой каталог, когда выдачу можно подтверждать вручную |
| REST API и вебхуки | Да | Автовыдача ключей и курсов, подписки, Telegram-боты, большой поток заказов |
Какие способы оплаты подключить для цифровых товаров
Чем больше удобных способов платежа, тем меньше брошенных корзин. В Paydex доступны три: СБП (QR-код и ссылка), банковские карты РФ и USDT в сетях TRC20 и BEP20.
| Способ оплаты | Кому удобен | Что учесть при продаже цифровых товаров |
|---|---|---|
| СБП (QR и ссылка) | Покупателям из России, которые платят из мобильного банка | Хорошо работает на мобильных и в Telegram: покупатель не вводит данные карты |
| Карты РФ | Тем, кто привык платить картой на сайте | Привычный сценарий для интернет-магазина курсов и ключей |
| USDT (TRC20, BEP20) | Зарубежной аудитории и крипто-сообществам | Подходит для международных продаж; покажите покупателю, какие сети поддерживаются |
Если аудитория российская, СБП и карты закрывают большинство сценариев. Если продаёте за рубеж или в крипто-среде, добавьте USDT. Размер комиссии зависит от оборота и тематики, актуальные условия смотрите на странице тарифов. Абонентской платы и платы за подключение нет.
Как настроить автоматическую выдачу товара после оплаты
Автовыдача строится на связке «заказ в вашей базе — платёж в шлюзе — вебхук — выдача». Порядок действий:
- Создайте заказ в своей базе со статусом «ожидает оплаты» и уникальным номером.
- Создайте платёж через API: передайте сумму и номер заказа, чтобы потом сопоставить их.
- Покажите покупателю ссылку на страницу оплаты на сайте или отправьте её в боте.
- Примите вебхук и проверьте его подпись.
- Найдите заказ, сверьте сумму, переведите статус в «оплачен».
- Выдайте товар: отправьте ключ на почту, откройте доступ в личном кабинете или пришлите файл в чат бота.
- Ответьте на вебхук кодом 2xx, чтобы шлюз понял, что доставка прошла.
Писать интеграцию с нуля не придётся: у Paydex есть REST API и SDK для Node.js, PHP и Python. Для старта хватит ключей API, которые вы получите после модерации проекта.
Совет. Прежде чем включать боевой режим, прогоните весь сценарий в тестовом режиме: создание платёжной ссылки, успешную оплату, отказ и повторный вебхук. Так вы найдёте ошибки в выдаче до первого реального покупателя.
Вебхуки оплаты: подпись, повторная доставка и идемпотентность
Вебхуки Paydex подписаны, а при неудачной доставке отправляются повторно. Из этого следуют три правила, которые защищают и вас, и покупателей.
Всегда проверяйте подпись
Адрес вашего обработчика могут узнать посторонние. Без проверки подписи любой сможет отправить запрос «оплачено» и получить ключ бесплатно. Подпись подтверждает, что вебхук пришёл именно от шлюза и не был изменён по дороге.
Рассчитывайте на повторы
Если ваш сервер был недоступен или ответил ошибкой, вебхук придёт снова. Это защита от потерянных заказов, но один и тот же вебхук может быть обработан дважды. Без защиты покупатель получит два ключа или продление подписки на двойной срок.
Сделайте обработку идемпотентной
- Храните идентификатор платежа и отметку «уже обработан» с уникальным индексом в базе.
- Перед выдачей проверяйте статус заказа: если он уже «выдан», просто ответьте 2xx.
- Смену статуса и выдачу товара делайте в одной транзакции.
- Тяжёлые операции (генерацию файла, письма) уносите в очередь и отвечайте на вебхук быстро.
- Сверяйте сумму и номер заказа из вебхука с данными в вашей базе.
Как принимать платежи за подписки и доступ на период
С точки зрения оплаты подписка — это платёж за определённый период плюс логика доступа на вашей стороне. Вебхук об успешном платеже служит сигналом: открыть доступ или продлить его срок.
- Храните у пользователя дату окончания доступа, а не просто флаг «оплачено».
- При оплате продлевайте срок от даты окончания, если доступ ещё действует, и от текущего момента, если он истёк.
- За несколько дней до окончания присылайте напоминание со ссылкой на оплату нового периода.
- Предложите выбор периода: месяц, квартал, год. Для каждого создавайте отдельный платёж с понятным описанием.
- По истечении срока закрывайте доступ автоматически, без ручных проверок.
Так подписки работают одинаково в боте и на сайте. Покупатель получает ссылку, оплачивает по СБП, картой или в USDT, а ваш сервис по вебхуку продлевает доступ.
Важно. Если продление у вас строится на напоминаниях и новой ссылке, прямо напишите об этом на странице товара. Покупатель не должен ждать автоматического списания, которого нет: это частая причина споров и возвратов.
Как организовать возвраты за цифровые товары
Продавцы цифровых товаров часто боятся возвратов, но прозрачные правила повышают доверие и конверсию. В Paydex возвраты покупателям делаются через кабинет и через API, поэтому их можно встроить в вашу админку.
Что прописать заранее
- В публичной оферте должен быть блок «Возврат»: без него проект не пройдёт модерацию.
- Опишите случаи, когда возврат возможен: ключ не активируется, доступ не открылся, товар не соответствует описанию.
- Укажите срок обращения и способ связи, куда писать.
- Формулировки об исключениях (например, после активации ключа) согласуйте с юристом: границы здесь зависят от типа товара.
Что делать при возврате
- Деактивируйте ключ или закройте доступ к курсу и подписке.
- Отметьте возврат в своей базе, чтобы товар не выдался повторно.
- Сообщите покупателю, что возврат оформлен.
Чёткая процедура экономит время поддержки: большинство обращений решается за один обмен сообщениями, если ключ или доступ действительно не работают.
Как начать принимать оплату с Paydex за один день
ИП и ООО для подключения не нужны: Paydex работает с обычными физическими лицами. Деньги накапливаются на балансе в USDT, а выводить их можно в USDT (TRC20, BEP20) или в рублях на карту либо по СБП.
- Пройдите регистрацию в Paydex.
- Создайте проект: сайт или Telegram-бот.
- Подтвердите домен или бота.
- Отправьте проект на модерацию, обычно она занимает до суток.
- Получите ключи API, настройте вебхуки и проверьте выдачу в тестовом режиме.
- Включите боевой режим и принимайте оплату.
Чтобы пройти модерацию с первого раза, подготовьте работающий сайт или бота, страницы с товарами и ценами, публичную оферту с блоком «Возврат» и контакты для связи. Подробный список есть в требованиях к сайту.
Если возникнут вопросы по интеграции или статусу модерации, поддержка отвечает в Telegram.
Частые ошибки при приёме платежей за цифровые товары
- Выдача по странице «Спасибо». Покупатель мог не вернуться на сайт, а без вебхука вы не узнаете об оплате. Ориентируйтесь только на подтверждение от шлюза.
- Нет проверки подписи вебхука. Это открытая дверь для бесплатных «покупок».
- Нет защиты от повторов. Один вебхук обрабатывается дважды, и покупатель получает два ключа.
- Не сверяется сумма. Заказ закрывается платежом на другую сумму или за другой товар.
- Закончился пул ключей. Оплата прошла, а выдавать нечего. Следите за остатком и приостанавливайте продажи заранее.
- Нет оферты и блока «Возврат». Из-за этого проект часто не проходит модерацию.
- Пропущено тестирование. Ошибки находят покупатели, а не вы.
Чаще всего проблемы решаются одним проходом по чек-листу: выдача по вебхуку, подпись, идемпотентность, сверка суммы, понятные условия возврата.
Частые вопросы
Нужно ли ИП, чтобы принимать оплату за цифровые товары?
Для подключения к Paydex ИП и ООО не нужны: мы работаем с обычными физическими лицами. Выводить деньги можно в USDT (TRC20, BEP20) и в рублях на карту или по СБП.
Как автоматически выдавать товар после оплаты?
Создайте платёж через API, дождитесь подписанного вебхука об успешной оплате, проверьте подпись и сумму, затем выдайте товар. Выдавать нужно по вебхуку, а не по возврату покупателя на сайт.
Что делать, если вебхук пришёл дважды?
Сделайте обработку идемпотентной: храните идентификатор платежа и перед выдачей проверяйте, не обработан ли он уже. Повторная доставка вебхуков — штатный механизм, поэтому дубли нужно просто игнорировать, отвечая 2xx.
Можно ли проверить интеграцию без реальных денег?
Да, в Paydex есть тестовый режим. В нём можно проверить создание платежа, успешную оплату, отказ и доставку вебхуков до запуска продаж.
Как сделать возврат за цифровой товар?
Возврат оформляется через кабинет Paydex или через API. После этого отзовите доступ или ключ и отметьте возврат в своей базе. Условия возврата должны быть прописаны в публичной оферте.
Какие способы оплаты можно подключить для продажи курсов и ключей?
Доступны СБП (QR-код и ссылка), банковские карты РФ и USDT в сетях TRC20 и BEP20. Страницу оплаты можно получить без кода, а автовыдачу настроить через API.
Как быстро можно начать принимать платежи?
После регистрации, создания проекта и подтверждения домена или бота проект проходит модерацию, обычно до суток. Затем вы получаете ключи API и можете включать приём оплаты.