Быстрый старт

Понадобится API-ключ активного магазина - как его получить, описано в разделе Аутентификация.

Шаг 1. Создайте платёж

Один POST-запрос с вашего сервера. Полное описание полей - в разделе Создание платежа.

curl -X POST https://tabpay.org/api/v1/payments \
  -H "X-Api-Key: tp_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "order-1001",
    "amountKopecks": 19900,
    "description": "Подписка на месяц"
  }'

В ответ придёт объект платежа со ссылкой на оплату:

{
  "id": "6b9d2c88-4b1a-4f0e-9c37-1f2ab34cd561",
  "orderId": "order-1001",
  "status": "CREATED",
  "amountKopecks": 19900,
  "commissionKopecks": 1393,
  "description": "Подписка на месяц",
  "method": null,
  "telegramId": null,
  "payUrl": "https://tabpay.org/pay/6b9d2c88-4b1a-4f0e-9c37-1f2ab34cd561",
  "paidAt": null,
  "createdAt": "2026-07-11T10:20:30.000Z"
}

Шаг 2. Отправьте покупателя на payUrl

Перенаправьте покупателя на адрес из поля payUrl (или отправьте ссылку сообщением - для ботов это обычный сценарий). На платёжной странице покупатель выберет СБП или карту и оплатит. Ссылка не сгорает, пока покупатель не начал оплату; после начала на оплату отводится 20 минут.

Шаг 3. Получите результат

Когда платёж завершится, TabPay пришлёт POST-запрос на Webhook URL вашего магазина:

{
  "id": "6b9d2c88-4b1a-4f0e-9c37-1f2ab34cd561",
  "orderId": "order-1001",
  "status": "SUCCESS",
  "amountKopecks": 19900,
  "telegramId": null
}

Проверьте подпись из заголовка X-Signature (раздел Проверка подписи), убедитесь, что status равен SUCCESS, - и выдавайте товар. Если вебхук настроить нельзя, статус можно запрашивать по API.

Готово: вы приняли первый платёж. Дальше стоит прочитать разделы про вебхуки (повторы и идемпотентность) и ошибки (что делать при сетевых сбоях).