PayX.uz
Платёжная инфраструктура для цифровых продуктов.
Простыми словами
- Что это
- Сервис, через который сайт или приложение принимает оплату через Payme, Click, Xazna и Oson, подключив всего одну систему.
- Для кого
- Владельцам интернет-магазинов и онлайн-сервисов и их программистам.
- Что это даёт
- Не нужно отдельно подключать каждую платёжную систему. Продавец выставляет счёт, покупатель платит удобным ему способом, а продавец автоматически получает подтверждение и видит все оплаты в одном кабинете.
PayX — платформа платёжных интеграций, позволяющая цифровому бизнесу принимать платежи через единый API для разработчиков. Мерчанты создают счета, получают надёжные колбэки и отслеживают каждую транзакцию и комиссию в одной панели.
Бизнес-контекст
Небольшие онлайн-бизнесы продают через Telegram и Instagram, и им нужно принимать платежи, не интегрируя каждого платёжного провайдера самостоятельно.
Проблема
Прямая интеграция платежей — медленный и рискованный путь для небольших команд: у каждого провайдера свой протокол, колбэки теряются или приходят дважды, а сверка комиссий и транзакций превращается в ручную работу.
Решение
Платформа на Laravel между мерчантами и процессингом платежей — понятный REST API для разработчиков, управление счетами, проверенные колбэки мерчантам, расчёт комиссий и полная история транзакций.
Что я сделал
Сделано в одиночку — архитектура, код и продакшен. Других разработчиков не было.
Архитектура
- Единая модель инвойса поверх четырёх провайдеров: Payme, Click, Xazna, OSON
- Подписанные вебхуки с повторными попытками на бэкенды мерчантов
- Песочница, имитирующая платежи
Backend
- Merchant API v1.2 (OpenAPI 3.0.3) на Laravel
- Жизненный цикл инвойса: pending → paid или cancelled
- Комиссия — процент для каждого платёжного провайдера; удерживается с мерчанта и никогда не добавляется к сумме плательщика
Frontend и приложения
- Кабинет мерчанта для платёжных ссылок и выплат
- Страница оплаты, где покупатель выбирает провайдера
- Публичная документация API и коллекция Postman
API и интеграции
- Payme, Click, Xazna, OSON
- Вебхук payment.completed с подписью HMAC-SHA256
- Вход через My-IT
База данных
- MySQL: инвойсы, платежи и ID транзакций провайдеров
Безопасность
- Bearer-токен на каждый проект
- HMAC по timestamp и телу запроса, окно ±5 минут и сравнение за постоянное время
- Доставка вебхуков не следует редиректам
Выпуск и эксплуатация
- Раздельные токены для песочницы и продакшена
- Повторы вебхуков: сразу, затем через 30 с, 2 мин, 10 мин и 30 мин, с таймаутом 10 с
Инженерный разбор: Жизненный цикл инвойса — от ссылки до вебхука
- Бэкенд мерчанта создаёт инвойс через POST /invoice с токеном своего проекта.
- PayX возвращает uuid инвойса и pay_url; статус — «pending».
- Покупатель открывает pay_url и выбирает провайдера.
- PayX инициирует платёж в Payme, Click, Xazna или OSON.
- Провайдер подтверждает платёж и возвращает ID своей транзакции.
- Инвойс переходит в статус «paid», комиссия фиксируется.
- PayX отправляет вебхук payment.completed с подписью HMAC, повторяя попытку до пяти раз.
- Мерчант в любой момент может проверить статус через GET /invoice/{uuid}.
Технические решения и компромиссы
- Один инвойс, четыре провайдера — Мерчант создаёт один инвойс; покупатель выбирает Payme, Click, Xazna или OSON на странице оплаты. (Компромисс: PayX зависит от доступности каждого провайдера — зато мерчант интегрируется один раз.)
- Подписанные вебхуки с временным окном — Каждый вебхук несёт HMAC от timestamp и тела; устаревшие timestamp отклоняются. (Компромисс: Мерчанту нужно проверять подписи и следить за точностью часов — в документации показано, как это делать.)
- Повторы с ключом идемпотентности — Доставка повторяется до пяти раз, а invoice_uuid служит ключом идемпотентности, поэтому повторный вебхук ничего не меняет. (Компромисс: Мерчант может получить одно и то же событие дважды и должен дедуплицировать его по invoice_uuid.)
- Пушится только успех — Отправляется только payment.completed; отмену и истечение срока читают через GET /invoice/{uuid}. (Компромисс: Обработка вебхуков проще, но остальные статусы мерчант проверяет сам.)
Основные модули
- Интеграция с процессингом платежей
- Управление счетами
- Интеграция мерчантов
- Платёжные колбэки
- Управление комиссиями
- Учёт финансовых транзакций
- API для разработчиков
payx.uz
Boburbek