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

1. Зарегистрируйтесь и подтвердите email

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

2. Создайте проект и подтвердите домен

Проект — это ваш магазин или сервис: название, домен сайта, логотип для страницы оплаты, адреса возврата покупателя по умолчанию и webhook_url для уведомлений. Домен подтверждается одним из способов:

• DNS TXT — запись paydex-verify=<токен> на корне домена или на _paydex.<домен>;
• meta-тег — <meta name="paydex-verification" content="<токен>"> на главной странице;
• файл — https://<домен>/.well-known/paydex-verify.txt с токеном внутри.

После проверки проект уходит на модерацию (обычно 1 рабочий день, см. требования к сайту). Тестовые ключи работают сразу, боевые — после одобрения.

3. Получите API-ключи

В разделе «API-ключи» проекта вы увидите три значения:

4. Создайте счёт

Один POST-запрос. Обязательны только amount и orderId; полный список полей — в разделе Счета.

Перенаправьте покупателя на url. На странице оплаты тестового счёта вместо банка — кнопки «Успех», «Отказ», «Истёк»: нажмите «Успех», чтобы эмулировать оплату.

5. Примите вебхук

После оплаты мы отправим POST на webhook_url проекта с событием invoice.paid. Тело подписано заголовком X-Paydex-Signature — обязательно проверяйте подпись, примеры на четырёх языках есть в разделе Вебхуки.

Ответьте 200 в течение 10 секунд. Иначе мы повторим доставку по расписанию 1 мин → 5 мин → 30 мин → 2 ч → 12 ч → 24 ч.

6. Проверьте статус (по желанию)

Вебхук — основной источник правды, но статус всегда можно запросить напрямую, например при возврате покупателя на successUrl:

Переход в боевой режим

1. Дождитесь одобрения проекта модерацией (уведомление придёт на email).
2. Замените sk_test_… на sk_live_… в конфигурации — код менять не нужно.
3. Проведите один реальный платёж на минимальную сумму и убедитесь, что вебхук обработан.