RSPAY: приём платежей по API
Выставьте счёт, отдайте плательщику ссылку, а деньги придут на ваш кошелёк за вычетом комиссии. Криптовалюта и СБП, вебхуки с подписью, AML каждого платежа.
От счёта до зачисления
Вы выставляете счёт, остальное делает платформа: приём, AML и вебхук.
Выставляете счёт
Запросом POST /invoices или вручную в приложении.
Плательщик платит
Криптовалютой, с кошелька или по СБП. Платёж проходит AML.
Получаете вебхук
Событие 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
- Счета и ссылки
- Ссылку на оплату вставляйте в кнопку своего бота или отправляйте плательщику. Платёжная страница открывается внутри 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 занимает пару минут. Нужен кошелёк под ключ: напишите нам.