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

Приём платежей по СБП: вы создаёте счёт, отправляете покупателя на страницу оплаты, получаете уведомление о зачислении. Три запроса и один обработчик.

https://api.well-pay.pro

Авторизация

Каждый запрос — с заголовком X-API-Key. Ключ у каждой кассы свой.

X-API-Key: wp_live_ВАШ_КЛЮЧ

ВАШ_КЛЮЧ — не настоящий токен, а место под ваш: ключ выпускается в кабинете и выглядит как wp_live_… (бой) или wp_test_… (тест).

Создание счёта

POST /v1/invoices

В примере — wp_test_…: так удобнее пробовать. На проде подставьте свой wp_live_… и проверьте, что касса в боевом режиме.

curl -X POST https://api.well-pay.pro/v1/invoices \
  -H "X-API-Key: wp_test_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150000,
    "order_id": "order-10241",
    "description": "Заказ №10241",
    "success_url": "https://shop.ru/success",
    "fail_url": "https://shop.ru/fail"
  }'

Ответ 201 Created

{
  "id": "inv_3F8KQ2M1N7XBZ0RTVCWD9E",
  "order_id": "order-10241",
  "status": "pending",
  "mode": "test",
  "amount": 150000,
  "charged_amount": 150000,
  "fee": 18000,
  "net": 132000,
  "currency": "RUB",
  "checkout_url": "https://pay.well-pay.pro/i/xxxxxxxx",
  "qr_text": null,
  "expires_at": "2026-08-18T15:30:00+00:00",
  "paid_at": null
}

Отправьте покупателя на checkout_url — там уже есть QR, таймер и возврат в ваш магазин.

Сумма сверх лимита — это 422 с понятным текстом, а не отказ на стороне банка: счёт в таком случае не создаётся вовсе.

Статус счёта

GET /v1/invoices/{invoice_id}
GET /v1/orders/{order_id}
POST /v1/invoices/{invoice_id}/cancel

Второй метод пригодится, когда ответ на создание потерялся: вместо повторного создания спросите, что стало с заказом.

Вебхуки

Адрес обработчика задаётся на кассе. Там же при создании подписки один раз показывается секрет — им подписываются уведомления. Мы отправляем POST с JSON и ждём любой ответ 2xx. Не получили — повторим по расписанию 0, 1, 5, 30, 120, 360 минут.

{
  "id": "evt_3F8KQ2M1N7XBZ0RTVCWD9E",
  "event": "payment.succeeded",
  "created_at": "2026-08-18T15:04:11+00:00",
  "mode": "live",
  "data": {
    "invoice_id": "inv_3F8KQ2M1N7XBZ0RTVCWD9E",
    "order_id": "order-10241",
    "status": "paid",
    "amount": 150000,
    "charged_amount": 150000,
    "fee": 18000,
    "net": 132000,
    "currency": "RUB",
    "paid_at": "2026-08-18T15:04:10+00:00",
    "metadata": null
  }
}

Проверка подписи

Проверяйте её обязательно: без этого кто угодно, узнав ваш адрес, сможет прислать поддельное «оплачено».

X-WellPay-Signature: sha256=<hex>
X-WellPay-Timestamp: 1787060000
X-WellPay-Event: payment.succeeded
X-WellPay-Delivery: dlv_...

signature = HMAC_SHA256(secret, "{timestamp}.{сырое тело запроса}")

import hmac, hashlib

def verify(secret: str, signature: str, timestamp: str, raw_body: bytes) -> bool:
    payload = f"{timestamp}.".encode() + raw_body
    expected = "sha256=" + hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

Тестовый режим

Тестовый ключ доступен сразу после регистрации, до проверки компании. Счета создаются как настоящие, на странице оплаты есть кнопка «Оплатить (тест)» — она проводит полный цикл вместе с вебхуком.

Ошибки

{"status": "failed", "error_message": "Минимальная сумма платежа — 10,00 ₽"}