API для партнёров
Создавайте счета из своей кассы или сайта и получайте уведомления об оплате. Ключ — в кабинете → API. Все запросы по HTTPS к https://pay.exchangemoney.pro/api/pay/v1, JSON, заголовок Authorization: Bearer pk_live_….
Создать счёт
POST /api/pay/v1/invoices
Authorization: Bearer pk_live_…
Content-Type: application/json
{ "amountThb": 1500, "orderId": "A-1023", "description": "Столик 4" }
→ 201
{ "ok": true, "invoice": {
"id": "6bb9…", "status": "NEW",
"amountThb": 1500, "amountRub": 4194, "rateClient": 2.7959, "rateBase": 2.782, "markupPct": 0.5,
"expiresAt": "2026-09-23T04:45:38Z",
"payUrl": "https://pay.exchangemoney.pro/i/6bb9…", // страница счёта — можно отправить гостю
"qrImage": "data:image/png;base64,…", // картинка QR — покажите гостю
"sbpUrl": "https://qr.nspk.ru/…", // ссылка «открыть в банке» (на телефоне)
"orderId": "A-1023", "description": "Столик 4", "demo": false, "createdAt": "…" } }Курс фиксируется на 10 минут (expiresAt). Сумма в рублях округляется вверх до рубля. Ошибки: 400 с полем error, 401 — неверный ключ, 429 — больше 300 запросов в минуту.
Повторы без дублей. Передавайте orderId: повторный запрос с тем же orderId, пока счёт не истёк (или уже оплачен), вернёт тот же счёт с кодом 200 и "reused": true — безопасно повторять при обрыве связи.
Статус счёта
GET /api/pay/v1/invoices/{id}
→ { "ok": true, "invoice": { …, "status": "PAID", "paidAt": "…", "paidRub": 4194, "payerName": "Иванов И." } }
Статусы: NEW — ждёт оплаты · PAID — оплачен · EXPIRED — время вышло · CANCELLED — отменён.
Опрашивайте не чаще раза в 2–3 секунды.
Если гость оплатил уже показанный QR после истечения или отмены, счёт станет PAID
(ещё до 30 минут после срока) и придёт вебхук invoice.paid.Отменить счёт
POST /api/pay/v1/invoices/{id}/cancel
→ 200 { "ok": true, "invoice": { …, "status": "CANCELLED" } }
→ 409 { "error": "invoice is PAID" } // уже оплачен/истёк — отменять нечегоСписок счетов и баланс
GET /api/pay/v1/invoices?status=PAID&from=2026-09-01&to=2026-09-30&limit=200
GET /api/pay/v1/invoices?orderId=A-1023
from/to — дата YYYY-MM-DD (сутки Бангкока, to включительно) или ISO-время; limit до 200
GET /api/pay/v1/balance
→ { "ok": true, "balanceThb": 1507.5, "salesThb": 1500, "markupThb": 7.5, "paidOutThb": 0, "adjustmentsThb": 0, "markupPct": 0.5 }Вебхук об оплате
Адрес и секрет — в кабинете → API. Адрес — только https:// на стандартном порту 443, публичный хост; редиректы не выполняются. При оплате счёта мы отправляем POST; при ответе не 2xx повторяем до 10 раз с растущей паузой (1, 2, 4… минут). Событие по одному счёту может прийти повторно — сверяйте по invoice.id.
POST https://ваш-адрес
X-Pay-Timestamp: 1758600000
X-Pay-Signature: <hex HMAC-SHA256(secret, "1758600000." + тело)>
Content-Type: application/json
{ "event": "invoice.paid", "invoice": { "id": "…", "orderId": "A-1023", "amountThb": 1500, "amountRub": 4194,
"rateClient": 2.7959, "paidRub": 4194, "payerName": "Иванов И.", "paidAt": "…", "status": "PAID", "demo": false } }
Проверка подписи (Node.js):
const expected = crypto.createHmac('sha256', secret).update(ts + '.' + rawBody).digest('hex');
ok = expected === signature && Math.abs(Date.now()/1000 - ts) < 300Кнопка «Проверить» в кабинете шлёт пробное событие ping с той же подписью.
Telegram-бот как касса
Отправьте боту @PME_pay_bot сумму в батах (например, 1500) — он пришлёт QR и сумму в рублях, а после оплаты — сообщение с именем плательщика. /today — оплаты за сегодня, /balance — баланс (владельцу). Кассиров приглашает владелец в кабинете → QR → «Сотрудники».