Paydex

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

REST API v1 для приёма платежей по СБП и банковским картам: создаёте счёт, отправляете покупателя на страницу оплаты, получаете подписанный вебхук. Плоский JSON, без SDK-обязаловки — достаточно любого HTTP-клиента.

API v1 · обновлено 2026-09-12

Как устроен API

Базовый адрес — https://paydex.pro/api/v1. Все запросы и ответы — JSON в кодировке UTF-8, суммы передаются строками с двумя знаками после запятой ("1500.00"), время — в ISO 8601 (UTC). Аутентификация — секретным ключом проекта в заголовке Authorization: Bearer или HMAC-подписью тела запроса (см. Аутентификация).

Полный цикл платежа выглядит так (подробнее о том, что видит покупатель, — Страница оплаты):

  1. Ваш сервер вызывает POST /invoices с суммой и номером заказа — в ответ приходит url страницы оплаты.
  2. Вы перенаправляете покупателя на url. Он выбирает СБП или карту и платит.
  3. Мы отправляем на ваш webhook_url событие invoice.paid с подписью X-Paydex-Signature.
  4. Покупатель возвращается на ваш successUrl. Деньги уже на балансе — выводите из кабинета.

Эндпоинты v1

МетодПутьНазначение
POST/invoicesСоздать счёт и получить ссылку на оплату
GET/invoices/{id}Статус и данные счёта по id
GET/invoicesСписок счетов с фильтрами (status, from, to, orderId) и курсором
POST/invoices/{id}/refundПолный или частичный возврат покупателю
GET/refunds/{id}Статус возврата
GET/methodsДоступные способы оплаты, комиссии и лимиты
GET/balanceБаланс мерчанта: доступно и в обработке
POST/payoutsЗаявка на вывод через API — в разработке (v2). Пока выводы оформляются в кабинете.

Разделы

Начало

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

Пошагово: регистрация, проект и домен, API-ключи, создание счёта через POST /api/v1/invoices, страница оплаты и вебхук об оплате.

Начало

Аутентификация

Два способа авторизации запросов к API Paydex: Authorization: Bearer sk_live_… или X-Public-Id + X-Signature (HMAC-SHA256 от тела запроса). Лимиты и безопасность ключей.

Начало

Тестирование

Как проверить интеграцию без реальных денег: тестовые ключи sk_test_, кнопки «Успех / Отказ / Истёк» на тестовой странице оплаты, заголовок X-Paydex-Test и isTest в вебхуке.

API

Счета (invoices)

POST /api/v1/invoices и GET /api/v1/invoices: поля запроса и ответа, объект customer, список с фильтрами и курсором, идемпотентность по orderId, feePayer и method.

API

Статусы счёта

created → pending → paid | failed | expired, paid → refunded | partially_refunded. Какие статусы финальные, какие события вебхуков им соответствуют.

API

Вебхуки

Уведомления invoice.paid / failed / expired и refund.succeeded / failed на ваш URL. Конверт события, заголовки, проверка подписи HMAC-SHA256 на Node.js, PHP, Python и Go, повторы 1м–24ч.

API

Возвраты

Полный и частичный возврат покупателю через API или из кабинета: запрос, статусы возврата, вебхуки refund.succeeded / refund.failed, списание с баланса мерчанта.

API

Методы оплаты

Список способов оплаты, доступных проекту (СБП, банковские карты), с комиссией, лимитами суммы и флагом доступности для каждого метода.

API

Баланс

Получение баланса мерчанта через API: доступная к выводу сумма, средства в обработке, валюта. Когда баланс меняется.

Инструменты

Страница оплаты

Размещённая страница оплаты /pay/{id}: выбор СБП или карты, QR-код СБП, таймер, логотип проекта, возврат на successUrl / failUrl. Какие параметры счёта на неё влияют.

Инструменты

Платёжные ссылки

Создайте ссылку на оплату в кабинете Paydex и отправьте покупателю в мессенджер или соцсети. Без программирования, с уведомлениями об оплате.

Инструменты

Подтверждение домена

Три способа подтвердить домен проекта в Paydex и пошаговые инструкции для Tilda, WordPress, Nuxt и статических сайтов, Cloudflare DNS.

Справочник

Ошибки

Формат ошибки { error: { code, message } }, HTTP 400–503, справочник кодов: validation, unauthorized, signature_invalid, project_not_active, invoice_not_found, order_id_conflict, rate_limited и другие.

Справочник

Примеры кода

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

Справочник

История изменений

Изменения публичного API Paydex по версиям: что добавлено, что изменилось, что устарело.

Соглашения

  • Валюта — только RUB. Поле currency в ответах всегда "RUB".
  • Идентификаторы счетов — UUID. Ваш номер заказа передаётся в orderId и уникален в рамках проекта.
  • Идемпотентность — повторный POST /invoices с тем же orderId возвращает уже созданный счёт с кодом 200.
  • Лимит — 60 запросов в секунду на ключ; при превышении — 429.
  • Списки — { "items", "nextCursor", "hasMore" }, limit до 100.
  • Ошибки — всегда { "error": { "code", "message" } }, см. Ошибки.
  • Тест — ключи sk_test_ работают в песочнице, см. Тестирование.
  • Модерация — боевые ключи включаются после проверки сайта, см. требования к сайту.

Машиночитаемое

  • /docs/openapi.json — спецификация OpenAPI 3.1: эндпоинты, схемы Invoice, Refund, Error. Импортируйте в Postman / Insomnia или сгенерируйте клиент.
  • /docs/llms.txt — краткое описание API и карта разделов для ИИ-ассистентов.