# Paydex

> Paydex (paydex.pro) — платёжный шлюз для сайтов, сервисов и продаж в мессенджерах. Мерчант создаёт счёт через REST API v1, покупатель платит по СБП или банковской картой на размещённой странице оплаты, мерчант получает подписанный вебхук. Комиссия — процент с успешного платежа, абонентской платы нет. Выплаты на карту РФ, СБП и USDT TRC20.

Базовый адрес API: https://paydex.pro/api/v1. Аутентификация: Authorization: Bearer sk_live_… (или sk_test_…), альтернативно X-Public-Id + X-Signature (HMAC-SHA256 от тела). Ответы — плоский JSON, суммы строками ("1000.00"), даты ISO 8601 UTC. Ошибки — { error: { code, message } }. Списки — { items, nextCursor, hasMore }.

Эндпоинты: POST /invoices, GET /invoices/{id}, GET /invoices (фильтры status/from/to/orderId, limit≤100), POST /invoices/{id}/refund, GET /refunds/{id}, GET /methods, GET /balance.
Вебхуки: POST на webhook_url проекта, конверт { id, event, createdAt, data }, события invoice.paid|failed|expired, refund.succeeded|failed; заголовки X-Paydex-Signature (sha256=HMAC от сырого тела с webhook_secret), X-Paydex-Timestamp, X-Paydex-Event, X-Paydex-Delivery-Id, X-Paydex-Test; повторы 1м/5м/30м/2ч/12ч/24ч.
Статусы счёта: created → pending → paid | failed | expired; paid → refunded | partially_refunded.

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

- [Обзор API](https://paydex.pro/docs): REST API v1 платёжного шлюза Paydex: счета, вебхуки, возвраты, методы оплаты, баланс. Подключите приём платежей по СБП и картам на сайте за 10 минут.
- [Быстрый старт](https://paydex.pro/docs/quickstart): Пошагово: регистрация, проект и домен, API-ключи, создание счёта через POST /api/v1/invoices, страница оплаты и вебхук об оплате.
- [Аутентификация](https://paydex.pro/docs/auth): Два способа авторизации запросов к API Paydex: Authorization: Bearer sk_live_… или X-Public-Id + X-Signature (HMAC-SHA256 от тела запроса). Лимиты и безопасность ключей.
- [Тестирование](https://paydex.pro/docs/testing): Как проверить интеграцию без реальных денег: тестовые ключи sk_test_, кнопки «Успех / Отказ / Истёк» на тестовой странице оплаты, заголовок X-Paydex-Test и isTest в вебхуке.
- [Счета (invoices)](https://paydex.pro/docs/invoices): POST /api/v1/invoices и GET /api/v1/invoices: поля запроса и ответа, объект customer, список с фильтрами и курсором, идемпотентность по orderId, feePayer и method.
- [Статусы счёта](https://paydex.pro/docs/statuses): created → pending → paid | failed | expired, paid → refunded | partially_refunded. Какие статусы финальные, какие события вебхуков им соответствуют.
- [Вебхуки](https://paydex.pro/docs/webhooks): Уведомления invoice.paid / failed / expired и refund.succeeded / failed на ваш URL. Конверт события, заголовки, проверка подписи HMAC-SHA256 на Node.js, PHP, Python и Go, повторы 1м–24ч.
- [Возвраты](https://paydex.pro/docs/refunds): Полный и частичный возврат покупателю через API или из кабинета: запрос, статусы возврата, вебхуки refund.succeeded / refund.failed, списание с баланса мерчанта.
- [Методы оплаты](https://paydex.pro/docs/methods): Список способов оплаты, доступных проекту (СБП, банковские карты), с комиссией, лимитами суммы и флагом доступности для каждого метода.
- [Баланс](https://paydex.pro/docs/balance): Получение баланса мерчанта через API: доступная к выводу сумма, средства в обработке, валюта. Когда баланс меняется.
- [Страница оплаты](https://paydex.pro/docs/payment-page): Размещённая страница оплаты /pay/{id}: выбор СБП или карты, QR-код СБП, таймер, логотип проекта, возврат на successUrl / failUrl. Какие параметры счёта на неё влияют.
- [Платёжные ссылки](https://paydex.pro/docs/payment-links): Создайте ссылку на оплату в кабинете Paydex и отправьте покупателю в мессенджер или соцсети. Без программирования, с уведомлениями об оплате.
- [Подтверждение домена](https://paydex.pro/docs/domain-verification): Три способа подтвердить домен проекта в Paydex и пошаговые инструкции для Tilda, WordPress, Nuxt и статических сайтов, Cloudflare DNS.
- [Ошибки](https://paydex.pro/docs/errors): Формат ошибки { error: { code, message } }, HTTP 400–503, справочник кодов: validation, unauthorized, signature_invalid, project_not_active, invoice_not_found, order_id_conflict, rate_limited и другие.
- [Примеры кода](https://paydex.pro/docs/sdk): Полный цикл приёма платежа на четырёх языках: создание счёта, редирект на оплату, приём и проверка вебхука, запрос статуса счёта.
- [История изменений](https://paydex.pro/docs/changelog): Изменения публичного API Paydex по версиям: что добавлено, что изменилось, что устарело.

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

- [OpenAPI 3.1](https://paydex.pro/docs/openapi.json): спецификация всех эндпоинтов и схем Invoice / Refund / Error

## Прочее

- [Тарифы](https://paydex.pro/tariffs): комиссии по способам оплаты, лимиты, выводы
- [Требования к сайту](https://paydex.pro/legal/site-requirements): правила модерации проектов
- [Статус системы](https://paydex.pro/status): доступность СБП и карт
- [Контакты](https://paydex.pro/contacts): поддержка