PAYNEX Интеграция

Встречные заявки.
Один понятный процесс.

PAYNEX связывает депозит одного клиента с выплатой другому. Деньги переводятся напрямую, а мерчант создаёт заявки и получает результат через API.

Pay-In заявки 01
Новые заявки поступают через API
PAYNEX
Matching engine
МетодСуммаВалюта
Pay-Out 01
Осталось 5 000 ₽5 000 ₽
Реквизиты переданы в checkout
Новый Pay-In 2 000 ₽ в очереди

Что делает PAYNEX

Сводит пополнение и выплату

Если заявки совместимы по способу перевода, валюте и сумме, клиент с Pay-In получает реквизиты клиента с Pay-Out.

01

Прямой перевод

Рубли идут напрямую от клиента с депозитом клиенту с выплатой — без промежуточного транзитного кошелька.

02

Матчинг 1:1 и N:1

Один депозит связывается с одной выплатой, а крупная выплата может быть собрана из нескольких депозитов.

03

Понятный результат

Мерчант получает отдельные статусы Pay-In и Pay-Out. Успехом считается только completed.

От API до webhook

Как проходит операция

  1. 1

    Создать заявку

    Мерчант передаёт Pay-In или Pay-Out через REST API.

  2. 2

    Найти пару

    PAYNEX ищет заявку с тем же методом, валютой и подходящей суммой.

  3. 3

    Сделать перевод

    Клиент открывает checkout, переводит деньги и загружает чек.

  4. 4

    Получить результат

    Мерчант проверяет подписанный webhook или отдельный статус операции.

Два сценария

Один депозит целиком. Выплата — одной или несколькими частями

Pay-In не делится между выплатами. Pay-Out может принять несколько подходящих Pay-In и завершится после подтверждения всех частей.

Матч 1:1

5 000 ₽ ↔ 5 000 ₽

Один Pay-In полностью закрывает один Pay-Out. После проверки перевода оба направления получают completed.

Матч N:1

Одна выплата на 5 000 ₽

Pay-In 2 000 ₽ осталось 3 000 ₽
Pay-In 1 000 ₽ осталось 2 000 ₽
Pay-In 2 000 ₽ осталось 0 ₽

Если пары нет, заявка остаётся в matching до появления совместимого потока или истечения своего срока.

Контроль на каждом этапе

PAYNEX помогает подтвердить результат операции

Система объединяет данные заявки, чек, историю клиента и доступные сигналы риска, а мерчант получает единый финальный статус.

Связь с заявкой

Данные перевода и чека автоматически сопоставляются с конкретной операцией.

Умная проверка

История операций и поведенческие сигналы помогают выбрать подходящий сценарий проверки.

Подписанный результат

HMAC-SHA256 помогает мерчанту проверить источник и целостность каждого webhook.

Текущая конфигурация

Всё необходимое для понятного старта

Основные параметры собраны в одном месте, чтобы команда быстро настроила первый рабочий сценарий.

01

Автоматический матчинг

Заявка начинает поиск совместимого встречного потока сразу после создания.

02

RUB, карты и СБП

Готовый набор методов для самых привычных рублёвых переводов.

03

Точная сумма в API

PAYNEX возвращает фактический amount_kopecks, который можно сразу использовать в интерфейсе и учёте.

04

Прозрачные расчёты

GET /api/v1/balance показывает начисления и погашения комиссии в центах USDT.

Merchant API

Семь методов для основного потока

Создание Pay-In и Pay-Out, отдельный статус каждого направления, комиссионный баланс и собственный webhook для каждого потока.

  • Отдельные запросы статуса Pay-In и Pay-Out
  • Idempotency-Key для безопасных повторов
  • HMAC-SHA256 подпись входящих webhooks
POST /api/v1/payments
curl -X POST https://paynex.work/api/v1/payments \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: dep-0001" \
  -d '{
    "amount_kopecks": 500000,
    "payment_method": "card",
    "merchant_player_id": "user_42",
    "merchant_payment_id": "deposit_0001"
  }'
201 Createdcheckout_url: https://paynex.top/pay/…

Короткие ответы

Частые вопросы

Как быстро начинается матчинг?

Сразу после создания. PAYNEX держит операцию в matching, пока не появится совместимая встречная заявка в пределах заданного TTL.

Когда мерчант получает подтверждённый результат?

После завершения проверки операция получает completed. Этот статус приходит в webhook и доступен отдельным запросом Pay-In или Pay-Out.

Как получать статус удобным способом?

Pay-In запрашивается через GET /api/v1/payments/{payment_id}, Pay-Out — через GET /api/v1/payouts/{payout_id}.

Как использовать баланс в API?

GET /api/v1/balance возвращает начисленную комиссию за вычетом погашений в центах USDT — готовое значение для сверки расчётов.

Как настроить webhooks?

Для Pay-In и Pay-Out можно задать разные URL через PUT /api/v1/webhook. Для отдельной операции также можно передать свой webhook_url.

Подключите PAYNEX к платёжному контуру

Откройте готовый пример на Python, PHP, JavaScript, Go или cURL и адаптируйте его под свой проект.

Выбрать язык и скопировать код