RSPAY: приём платежей по API

Выставьте счёт, отдайте плательщику ссылку, а деньги придут на ваш кошелёк за вычетом комиссии. Криптовалюта и СБП, вебхуки с подписью, AML каждого платежа.

От счёта до зачисления

Вы выставляете счёт, остальное делает платформа: приём, AML и вебхук.

  1. Выставляете счёт

    Запросом POST /invoices или вручную в приложении.

  2. Плательщик платит

    Криптовалютой, с кошелька или по СБП. Платёж проходит AML.

  3. Получаете вебхук

    Событие invoice.paid с подписью. Деньги на вашем кошельке за вычетом комиссии.

Запрос: создать счёт
POST /invoices{  "amount": "100",  "title": "Заказ №104",  "external_id": "ORD-104"}
Ответ
{ "invoice": {    "id": "210",    "status": "created",    "amount": "100",    "fee": "1",    "net_amount": "99",    "pay_url": "https://t.me/<бот>?startapp=…"} }
Вебхук: счёт оплачен
{  "type": "invoice.paid",  "data": { "invoice": { "id": "210", "status": "paid" } }}
  • POST /invoices
  • GET /invoices/{id}
Документация RSPAY

Что умеет RSPAY

Счета и ссылки
Ссылку на оплату вставляйте в кнопку своего бота или отправляйте плательщику. Платёжная страница открывается внутри Telegram.
Криптовалюта и СБП
Плательщик платит с кошелька в приложении, ончейн или по СБП. СБП зачисляется с заморозкой на сутки.
Вебхуки с подписью
События paid, under_review, expired и cancelled с подписью HMAC-SHA256. Повторы доставки до 8 раз.
AML каждого платежа
Пока проверка не пройдена, деньги не зачисляются, а адрес с непроверенными монетами больше не выдаётся.
Без дублей
Повторный запрос с тем же external_id вернёт тот же счёт, а не создаст новый.
Понятная комиссия
Процент, но не менее минимума за платёж. Фиксируется при создании счёта и дальше не меняется.

Как подключиться

Подключение доступно всем, без заявок.

1Подключите RSPAY
В боте: Профиль, RSPAY, «Подключить».
2Создайте ключ
Раздел «API и вебхуки»: ключ показывается один раз, адрес вебхука по желанию.
3Выставьте счёт
Методом POST /invoices или вручную в приложении, без API.

Не только приём платежей

На архитектуре RSPAY можно построить собственный кастодиальный кошелёк: учёт, адреса для депозитов, AML входящих и выводы.

Кошелёк под ключ

Частые вопросы

Как начать принимать платежи?

Подключите RSPAY в Telegram-боте (Профиль, RSPAY, «Подключить»), создайте API-ключ и выставляйте счета методом POST /invoices. В ответе придёт ссылка на оплату: вставьте её в кнопку своего бота или отправьте плательщику.

Какие способы оплаты поддерживаются?

Плательщик платит криптовалютой, с кошелька в приложении или по СБП. Сумма по СБП зачисляется с заморозкой на сутки.

Что будет с платежом, который не прошёл AML-проверку?

Пока проверка не пройдена, деньги вам не зачисляются, а счёт остаётся в статусе under_review. Адрес, на который пришли непроверенные монеты, больше не выдаётся под оплаты.

Как узнать, что счёт оплачен?

Укажите адрес вебхука: мы отправим POST с подписью X-RSPAY-Signature (HMAC-SHA256). События: invoice.paid, invoice.under_review, invoice.expired и invoice.cancelled. Если ответа нет, доставка повторяется до 8 раз.

Какая комиссия?

Процент, но не менее минимума за платёж. Она фиксируется при создании счёта и дальше не меняется. При оплате криптой дополнительно удерживается комиссия сети.

Начните принимать платежи

Подключение в Telegram занимает пару минут. Нужен кошелёк под ключ: напишите нам.