Документация plopay

1Что такое plopay

plopay — технологическая платформа приёма платежей. Она регистрирует оплату, ведёт учёт операций, показывает аналитику и формирует запросы на конвертацию и выплату. Сами денежные средства проходят через участников финансовой инфраструктуры — платформа их не хранит.

Что вы получаете:

• приём платежей несколькими методами с настраиваемым распределением комиссии;
• личный кабинет с аналитикой, историей операций и уведомлениями;
• автоматическую конвертацию рублёвой выручки в USDT;
• вывод на подключённый кошелёк или карту.

2Путь платежа

От оплаты покупателем до денег на вашем кошельке проходит четыре этапа. Все они видны в кабинете в разделе «Конвертация».

3Статусы операций

4Подключение

Учётные записи создаются вручную — самостоятельной регистрации нет. Порядок такой:

1. Оставьте заявку на сайте или напишите в Telegram.
2. Менеджер уточняет вид деятельности, ожидаемые обороты и нужные методы приёма.
3. Вам создают кассу и передают логин и пароль от личного кабинета.
4. При первом входе смените пароль в разделе «Настройка проекта».

Вход в кабинет — на странице plopay.io/cabinet.

5Личный кабинет

Период задаётся в верхней панели: сегодня, 7 дней, 30 дней, за всё время или произвольный диапазон через календарь. Выбор действует и на «Обзор», и на «Аналитику». Валюту отображения можно переключить между рублём и USDT.

6Методы приёма и комиссия

Методы подключает менеджер. У каждого метода есть общий размер комиссии, который делится между вами и покупателем.

Что вы можете изменить сами: распределение комиссии. Откройте «Методы приёма» → «Редактировать» и задайте, какая часть ложится на вас, а какая на покупателя. Доли связаны — при изменении одной вторая пересчитывается, сумма всегда равна общему размеру комиссии.

Что меняет только менеджер: наименование метода, тип, общий размер комиссии и адрес перенаправления. Менеджер также может временно закрыть метод — тогда он отображается как «Отключен», а платежи этим методом не принимаются.

7Конвертация и курс

Рублёвая выручка конвертируется в USDT раз в сутки после 17:00 МСК. Курс устанавливает платформа: он может быть фиксированным либо считаться от котировки биржи с наценкой.

В разделе «Конвертация» отображается:

• действующий курс в обе стороны;
• сумма в очереди и сколько USDT вы получите по текущему курсу;
• сколько сейчас на холде;
• время ближайшего запуска и была ли конвертация сегодня.

В истории конвертаций сохраняется курс, по которому фактически прошла каждая конвертация.

8Вывод средств

1. Добавьте способ вывода в разделе «Кошельки и карты».
2. В разделе «Выводы» укажите валюту и сумму, создайте заявку.
3. Заявка получает статус «На выводе» и уходит в обработку.
4. Заявки обрабатываются ежедневно с 18:00 до 20:00 МСК.

Отдельный способ вывода — на криптокошелёк или на карту — может быть временно закрыт для кассы. Валюты закрытого способа недоступны в форме вывода, над формой показывается пометка.

9API для интеграции

Сервер вашего магазина может работать с plopay напрямую: создавать платежи, читать статусы и балансы, заказывать выплаты и получать уведомления об изменениях.

Авторизация

Ключ и секрет — в кабинете, раздел «Настройка проекта». Ключ передаётся заголовком в каждом запросе, секретом подписываются наши уведомления к вам, а если для кассы включена подпись запросов — и ваши запросы к нам. Оба держите только на сервере.

curl https://plopay.io/api/v1/me \
          -H "X-Api-Key: ВАШ_КЛЮЧ"

Лимиты

На один ключ — 60 запросов в минуту, из них не больше половины на создание платежей и выплат. Для кассы лимит может быть изменён: действующее значение возвращает GET /api/v1/me в поле rate_limit. Сверх лимита — ответ 429 с телом rate_limited и заголовком Retry-After: через сколько секунд повторить. Тело запроса — не больше 64 КБ. Запросы без ключа или с неверным ключом ограничены 30 в минуту с одного IP.

Подпись запросов

Для кассы может быть включена обязательная подпись — тогда одного ключа недостаточно (признак возвращает GET /api/v1/me в поле signature_required). Добавляйте к каждому запросу два заголовка: X-Plopay-Timestamp — текущее время в секундах (Unix) и X-Plopay-Signature — HMAC-SHA256 вашим секретом от строки timestamp.METHOD.path.body. Здесь path — путь вместе со строкой запроса, body — тело ровно в том виде, в каком вы его отправляете (для GET — пустая строка).

const ts = Math.floor(Date.now() / 1000).toString();
        const body = JSON.stringify({ amount: 3400, currency: 'RUB', order_id: 'ORDER-1' });
        const signature = crypto.createHmac('sha256', SECRET)
          .update(ts + '.POST./api/v1/payments.' + body)
          .digest('hex');

Метка времени не должна расходиться с нашей больше чем на 5 минут, а подпись POST-запроса принимается только один раз — при повторе подпишите запрос заново.

Методы

Создание платежа

curl -X POST https://plopay.io/api/v1/payments \
          -H "X-Api-Key: ВАШ_КЛЮЧ" -H "Content-Type: application/json" \
          -d '{"amount": 3400, "currency": "RUB", "order_id": "ORDER-1", "description": "Заказ №1"}'

{
          "id": "tx_d732f16db5dc",
          "order_id": "ORDER-1",
          "status": "pending",
          "internal_status": "hold",
          "amount": 3400,
          "currency": "RUB",
          "created_at": "2026-09-12T20:15:04.851Z",
          "hold_until": "2026-09-13T20:15:04.851Z"
        }

Статусы в ответах

Уведомления (webhooks)

Укажите адрес в кабинете, раздел «Настройка проекта» — и мы будем присылать POST при каждом изменении: payment.created, payment.processing, payment.succeeded, payout.created.

X-Plopay-Event: payment.succeeded
        X-Plopay-Delivery: wh_9f2c1a4b7e02
        X-Plopay-Signature: <HMAC-SHA256 тела запроса вашим секретом>

Проверяйте подпись — так вы убедитесь, что уведомление пришло от нас:

const ok = crypto.createHmac('sha256', SECRET)
          .update(rawBody)
          .digest('hex') === req.headers['x-plopay-signature'];

Если вебхуки отключены для кассы, уведомления не отправляются — статусы можно запрашивать методом GET /api/v1/payments/{id}.

Отвечайте кодом 2xx. Если ответа нет или он другой, мы повторим через 1, 5, 15, 60 и 180 минут — пять попыток. Историю доставки и повторную отправку можно запросить у поддержки.

Ошибки

10Ограничения и проверки

Платформа проверяет характер операций и вид деятельности. Полный перечень запрещённых направлений и оснований для ограничительных мер — в разделах 7, 8 и 10 Публичной оферты.

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

11Поддержка

Кнопка «Техподдержка» внизу бокового меню кабинета открывает наш Telegram — это основной канал связи, отвечаем там быстрее всего.

Telegram: @PloPay_bot
Почта: merchantsplopay@gmail.com

Чтобы ответ был быстрее, укажите идентификатор кассы и, если вопрос по конкретной операции, её сумму и дату.