VangardPay — Merchant Portal

Единый портал для мерчантов VangardPay — руководство по работе с платформой, управлению балансом, разрешению апелляций и интеграции по API.

work Merchant Dashboard

Вывод средств

Доступный баланс отображается на главном экране Dashboard. Для вывода нажмите «Вывести».

История операций

Раздел отображает полную историю движения средств по вашему балансу.

Доступные фильтры:

• Тип операции: все / входящие (CREDIT, DEPOSIT) / исходящие (DEBIT, WITHDRAW)
• Сортировка: по дате, сумме, типу

Данные в таблице:

Финансовая отчётность (экспорт)

Выгрузка статистики в формате Excel за произвольный период.

Как выгрузить:

1. Откройте Настройки → Отчётность
2. Укажите период (начальная и конечная дата)
3. Нажмите «Экспорт»

Состав отчёта:

• Сводка по аккаунту за выбранный период
• Входящие платежи (Pay-In) — все успешные операции приёма
• Исходящие платежи (Pay-Out) — все успешные операции отправки
• Депозиты — успешные пополнения баланса
• Выводы — успешные операции вывода средств

История транзакций

Раздел содержит все транзакции в финальном статусе: Успешно или Отклонено.

Типичные причины отклонения:

• Сумма платежа не совпала с суммой в ордере — это может привести к потере средств
• Плательщик использовал неверные реквизиты (при оплате через СБП возврат практически невозможен)
• Истекло время ожидания оплаты — транзакция закрыта автоматически

Доступные фильтры: дата, статус, способ оплаты, внешний ID (ExtID), внутренний ID.

Данные в таблице:

balance Апелляции

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

Классификация апелляций

Категория A. Ошибка плательщика

Качество информирования плательщика на платёжной форме напрямую влияет на количество апелляций. Рекомендуем максимально проработать UX вашей платёжной страницы.

Категория B. Фрод

Категория C. Техническая ошибка

В редких случаях автоматика платформы может не обработать корректный платёж. Причины: сбой на стороне банка, задержка SMS-подтверждения, проблемы со связью. VangardPay постоянно совершенствует систему для минимизации таких случаев.

Требования к доказательствам

Для успешного рассмотрения апелляции необходимо предоставить подтверждающие документы в одном из следующих форматов:

Банковский чек (PDF)

• Финальный статус перевода — «Успешно» или «Исполнено»
• Данные получателя — видно, на чей счёт поступил перевод
• Точная сумма перевода
• Дата и время операции
• Без посторонних персональных данных

Видеозапись экрана

• Начало записи — с момента входа в интернет-банк (после ввода пароля)
• Видна операция с подтверждённым статусом
• Чётко отображены: сумма, дата, реквизиты получателя
• Отсутствует информация, не относящаяся к платежу

Банковская выписка

• Чётко разделены приходные и расходные операции
• Видны суммы, даты и время каждой транзакции
• Указан номер карты, счёта или привязанного телефона

Аудиозапись звонка в банк

• Запись ведётся с отдельного устройства — в кадре виден номер телефона горячей линии
• Оператор банка озвучивает название кредитной организации
• В ходе разговора уточняются: реквизиты, дата, время и сумма перевода
• Запрашивается информация о статусе перевода и возможных задержках

Процедура рассмотрения апелляций

Подача апелляции

Мерчант создаёт апелляцию через API (рекомендуется) или через Портал апелляций. Апелляция поступает трейдеру на рассмотрение.

Рассмотрение трейдером

• Платёж найден и не привязан к другому ордеру → трейдер подтверждает → апелляция одобрена
• Платёж не найден → трейдер отклоняет с банковской выпиской → апелляция передаётся на проверку саппорту → возможна вторичная апелляция (см. ниже)
• Платёж зачтён по другому ордеру → окончательное отклонение, вторичная апелляция невозможна

Вторичная апелляция (2 этапа)

Вторичная апелляция возможна только при отклонении по причине «Платёж не обнаружен». Следующие причины отклонения являются окончательными и не подлежат вторичной апелляции:

• Зачтён по другому ордеру — платёж уже привязан к другой операции
• Фрод (категория B) — повторные попытки могут привести к блокировке

Иерархия веса доказательств (от слабого к сильному):

Этап 1. Первичная апелляция

Мерчант создаёт апелляцию и прикладывает чек плательщика. Апелляция поступает трейдеру.

Действия трейдера:

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

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

Действия мерчанта (ожидание ответа):

• Мерчант не отправляет документы в течение 24 часов → апелляция отклонена
• Мерчант не согласен и плательщик прикладывает видео списания → апелляция переходит на вторичное рассмотрение

Этап 2. Вторичная апелляция

Трейдер получает вторичную апелляцию с видео плательщика.

Действия трейдера:

• Трейдер предоставляет встречное видео → решение в пользу трейдера → апелляция отклонена (видео трейдера имеет наибольший вес)
• Трейдер не предоставляет видео в течение 3 банковских дней или вручную подтверждает апелляцию → апелляция закрывается в пользу мерчанта

Сроки рассмотрения (SLA)

Служба апелляций работает круглосуточно, 7 дней в неделю.

currency_exchange Расчёты и конвертация

Курсообразование

Все расчёты на платформе выполняются по рыночному курсу, сформированному на основе агрегированных данных P2P-площадок (ByBit, Rapira и др.). Курс обновляется в реальном времени.

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

Формула начислений

При зачислении средств на баланс мерчанта из суммы платежа удерживается комиссия. Расчёт производится в три этапа.

Исходные данные:

• fee — ваша комиссия (%)
• rate — текущий курс фиатной валюты к USDT
• amount — сумма платежа в фиатной валюте

Все промежуточные значения округляются до 2 знаков после запятой по стандартным математическим правилам (≥ 0.005 → вверх).

gavel Правила и ответственность

Настоящий раздел определяет обязательства мерчанта при работе с платформой VangardPay. Нарушение условий может повлечь финансовую ответственность в соответствии с заключённым договором.

1. Соответствие согласованным параметрам трафика

Изменение типа или географии трафика без предварительного согласования с VangardPay не допускается. При выявлении несоответствия между фактическими параметрами трафика и условиями договора платформа вправе применить штрафные санкции.

2. Раскрытие информации об источниках трафика

Мерчант обязан предоставлять полные и достоверные сведения обо всех источниках трафика. Сокрытие информации или предоставление ложных данных влечёт ответственность согласно условиям договора.

3. Добросовестность транзакций

Мерчант несёт ответственность за качество предоставляемых заявок. Намеренная подача недобросовестных или фиктивных ордеров является грубым нарушением условий сотрудничества.

4. Комплаенс при обменных операциях

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

5. Компенсация убытков

Если действия мерчанта или плательщиков, действующих от имени мерчанта, привели к материальному ущербу для трейдеров платформы, мерчант обязан возместить убытки в полном объёме. Возмещение производится путём списания средств с баланса после предоставления платформой обоснованных доказательств.

Ежемесячно (30-го числа) VangardPay направляет мерчанту акт сверки с детализацией всех случаев.

6. Информирование плательщиков

Мерчант обязан доводить до плательщиков правила совершения платежей и последствия их нарушения. Рекомендуется размещать краткую инструкцию непосредственно на платёжной форме.

7. Защита от автоматизированных атак

Мерчант обязан реализовать на своей стороне защиту от парсинга и перебора платёжных реквизитов (rate limiting, CAPTCHA, мониторинг аномалий).

API Reference

Полная техническая документация для интеграции с платёжной платформой VangardPay. Все запросы выполняются через HTTPS.

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

Четыре шага, чтобы начать принимать платежи:

Способы интеграции

Формат ответов

Все ответы в формате JSON. Успешные запросы возвращают данные напрямую. При ошибке — стандартный объект ошибки.

Формат ошибок

Все ошибки возвращаются в унифицированном формате с типизированным errorCode. Полный список кодов — в разделе Коды ошибок внизу страницы.

{
  "statusCode": 404,
  "errorCode": "ORDER_NOT_FOUND",
  "message": "Ордер не найден",
  "details": null,
  "timestamp": "2026-03-18T12:00:00.000Z",
  "path": "/api/v1/orders/by-id/..."
}

code Ордера Pay-in

Создание ордеров на пополнение через API с заголовком X-API-Key.

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

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

Внутрибанковский трафик

При указании поля bank в запросе система подберёт реквизиты только того же банка. Это обеспечивает внутрибанковский перевод — быстрее, надёжнее, без межбанковских комиссий.

Пример запроса с внутрибанком:

curl -X POST https://api.vangardpay.com/api/v1/orders \\\\
  -H "X-API-Key: YOUR_API_KEY" \\\\
  -H "Content-Type: application/json" \\\\
  -d '{"type": "DEPOSIT", "amount": 5000, "method": "CARD_NUMBER", "bank": "SBERBANK"}'

↑ Ордер будет обрабатываться только реквизитами Сбербанка (перевод карта→карта внутри банка).

Уникализация суммы

Система автоматически корректирует сумму ордера (+1 ₽), если у того же держателя в том же банке уже есть активный ордер с такой суммой. Это необходимо для корректной автоматической привязки платежей.

curl -X POST https://api.vangardpay.com/api/v1/orders \\
  -H "X-API-Key: YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "type": "DEPOSIT",
    "amount": 5000,
    "method": "SBP",
    "bank": "SBERBANK",
    "callbackUrl": "https://your-site.com/webhook"
  }'

{
  "order": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "invId": "ORDER_1710528000_abc123",
    "status": "PENDING",
    "amount": 5000,
    "currency": "RUB",
    "trader": { "name": "Трейдер 1" },
    "requisite": {
      "id": "req-uuid",
      "method": "SBP",
      "cardNumber": null,
      "sbpPhoneNumber": "+79991234567",
      "accountNumber": null,
      "holder": {
        "firstName": "Иван",
        "lastName": "Иванов",
        "phoneNumber": "+79991234567",
        "bank": { "name": "Сбербанк", "code": "SBERBANK" }
      }
    },
    "merchant": { "displayName": "My Store" },
    "createdAt": "2026-03-16T18:00:00.000Z"
  },
  "paymentDetails": {
    "bankName": "Сбербанк",
    "bankCode": "SBERBANK",
    "paymentMethod": "SBP",
    "instructions": "Переведите 5000 RUB на указанные реквизиты"
  }
}

curl -X GET https://api.vangardpay.com/api/v1/orders/ORDER_123/status \\
  -H "X-API-Key: YOUR_API_KEY"

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "invId": "ORDER_123",
  "status": "COMPLETED",
  "amount": 5000,
  "factAmount": 4997.50,
  "createdAt": "2026-03-16T18:00:00.000Z",
  "completedAt": "2026-03-16T18:15:00.000Z",
  "appeals": []
}

curl -X GET "https://api.vangardpay.com/api/v1/orders?status=COMPLETED&page=1&limit=10" \\
  -H "X-API-Key: YOUR_API_KEY"

{
  "data": [{
    "id": "a1b2c3d4-...", "invId": "ORDER_123", "type": "DEPOSIT",
    "status": "COMPLETED", "currency": "RUB", "amount": 5000,
    "factAmount": 4997.50, "bank": "SBERBANK", "method": "SBP",
    "createdAt": "2026-03-16T18:00:00.000Z",
    "completedAt": "2026-03-16T18:15:00.000Z",
    "expiresAt": "2026-03-16T18:30:00.000Z", "appeals": []
  }],
  "meta": { "total": 42, "page": 1, "limit": 10, "totalPages": 5 }
}

curl -X GET https://api.vangardpay.com/api/v1/orders/by-id/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \\
  -H "X-API-Key: YOUR_API_KEY"

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "invId": "ORDER_123", "type": "DEPOSIT", "status": "COMPLETED",
  "currency": "RUB", "amount": 5000, "factAmount": 4997.50,
  "exchangeRate": 92.5, "usdtAmount": 54.05, "merchantFee": 2.50,
  "bank": "SBERBANK", "method": "SBP",
  "callbackUrl": "https://your-site.com/webhook", "callbackSent": true,
  "expiresAt": "2026-03-16T18:30:00.000Z",
  "createdAt": "2026-03-16T18:00:00.000Z",
  "completedAt": "2026-03-16T18:15:00.000Z",
  "paidAt": "2026-03-16T18:14:50.000Z", "appeals": []
}

curl -X POST https://api.vangardpay.com/api/v1/orders/a1b2c3d4-.../cancel \\
  -H "X-API-Key: YOUR_API_KEY"

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "invId": "ORDER_123", "status": "CANCELLED",
  "amount": 5000, "currency": "RUB",
  "createdAt": "2026-03-16T18:00:00.000Z",
  "completedAt": "2026-03-16T18:20:00.000Z"
}

curl -X GET https://api.vangardpay.com/api/v1/balance \\
  -H "X-API-Key: YOUR_API_KEY"

{
  "merchant": {
    "id": "m-abc123", "displayName": "My Store",
    "balance": 15250.75, "isVerified": true
  }
}

curl -X GET https://api.vangardpay.com/api/v1/banks \\
  -H "X-API-Key: YOUR_API_KEY"

[
  { "id": "bank-uuid-1", "name": "Сбербанк", "code": "SBERBANK", "logoUrl": "/uploads/banks/sber.png", "countryCode": "RU" },
  { "id": "bank-uuid-2", "name": "Тинькофф", "code": "TINKOFF", "logoUrl": "/uploads/banks/tinkoff.png", "countryCode": "RU" }
]

output Вывод Pay-out

Создание заявок на вывод средств с баланса мерчанта в USDT на TRC-20 кошелёк. Маршрут: /api/withdrawals. Авторизация: Bearer JWT.

curl -X POST https://api.vangardpay.com/api/withdrawals \\
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "merchantId": "m-abc123",
    "amount": 500,
    "walletAddress": "TJYs7pEqSKVaKnbeed1HpKr1MBGGGEaK1Y",
    "comment": "Вывод за март"
  }'

{
  "id": "wd-uuid-123",
  "merchantId": "m-abc123",
  "amount": 500,
  "currency": "USDT",
  "walletAddress": "TJYs7pEqSKVaKnbeed1HpKr1MBGGGEaK1Y",
  "bankDetails": null,
  "comment": "Вывод за март",
  "status": "PENDING",
  "adminComment": null,
  "processedBy": null,
  "processedAt": null,
  "txHash": null,
  "completedAt": null,
  "createdAt": "2026-03-18T12:00:00.000Z",
  "updatedAt": "2026-03-18T12:00:00.000Z",
  "merchant": {
    "id": "m-abc123",
    "displayName": "My Store",
    "user": { "id": "user-uuid", "login": "merchant@example.com" }
  }
}

curl -X GET "https://api.vangardpay.com/api/withdrawals?page=1&limit=10&status=PENDING" \\
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

{
  "data": [{
    "id": "wd-uuid-123",
    "merchantId": "m-abc123",
    "amount": 500,
    "currency": "USDT",
    "walletAddress": "TJYs...",
    "status": "PENDING",
    "comment": "Вывод за март",
    "adminComment": null,
    "txHash": null,
    "createdAt": "2026-03-18T12:00:00.000Z",
    "merchant": {
      "id": "m-abc123",
      "user": { "id": "user-uuid", "login": "merchant@example.com" }
    }
  }],
  "meta": { "page": 1, "limit": 10, "total": 5, "totalPages": 1 }
}

curl -X GET https://api.vangardpay.com/api/withdrawals/wd-uuid-123 \\
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

{
  "id": "wd-uuid-123",
  "merchantId": "m-abc123",
  "amount": 500,
  "currency": "USDT",
  "walletAddress": "TJYs7pEqSKVaKnbeed1HpKr1MBGGGEaK1Y",
  "bankDetails": null,
  "comment": "Вывод за март",
  "status": "COMPLETED",
  "adminComment": "Одобрено",
  "processedBy": "admin-uuid",
  "processedAt": "2026-03-18T14:00:00.000Z",
  "txHash": "abc123def456...",
  "completedAt": "2026-03-18T15:00:00.000Z",
  "createdAt": "2026-03-18T12:00:00.000Z",
  "updatedAt": "2026-03-18T15:00:00.000Z",
  "merchant": {
    "id": "m-abc123",
    "user": { "id": "user-uuid", "login": "merchant@example.com" }
  }
}

curl -X PATCH https://api.vangardpay.com/api/withdrawals/wd-uuid-123/cancel \\
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

{
  "id": "wd-uuid-123",
  "status": "CANCELLED",
  "amount": 500,
  "processedAt": "2026-03-18T13:00:00.000Z"
}

Статусы заявок

я страница

Создайте платёжную сессию и перенаправьте клиента на страницу VangardPay. Клиент сам выберет сумму и метод.

curl -X POST https://api.vangardpay.com/api/v1/payment-sessions \\
  -H "X-API-Key: YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "minAmount": 500, "maxAmount": 50000,
    "allowedMethods": "["SBP", "CARD_NUMBER"]",
    "callbackUrl": "https://your-site.com/webhook",
    "successUrl": "https://your-site.com/success",
    "failUrl": "https://your-site.com/fail",
    "externalId": "ORDER_456"
  }'

{
  "sessionId": "session-uuid-123",
  "token": "ps_a1b2c3d4e5f6",
  "paymentUrl": "https://pay.vangardpay.com/pay/ps_a1b2c3d4e5f6",
  "expiresAt": "2026-03-16T19:00:00.000Z"
}

gavel Апелляции

Если ордер завершился некорректно (клиент оплатил, но статус не подтвердился), создайте апелляцию.

curl -X POST https://api.vangardpay.com/api/appeals \\
  -H "X-API-Key: YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "invId": "ORDER_123",
    "reason": "Платёж не зачислен",
    "comment": "Клиент отправил 5000 руб, приложен чек",
    "images": ["https://api.vangardpay.com/uploads/appeals/appeal-123.jpg"]
  }'

{
  "id": "appeal-uuid-123",
  "orderId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "reason": "Платёж не зачислен",
  "comment": "Клиент отправил 5000 руб, приложен чек",
  "status": "PENDING",
  "images": "["https://api.vangardpay.com/uploads/appeals/appeal-123.jpg"]",
  "videos": null, "documents": null,
  "deadline": "2026-03-19T18:00:00.000Z",
  "createdAt": "2026-03-16T18:00:00.000Z",
  "order": {
    "id": "a1b2c3d4",
    "merchant": { "id": "m-abc", "displayName": "My Store" },
    "provider": null
  }
}

curl -X POST https://api.vangardpay.com/api/appeals/upload \\
  -H "X-API-Key: YOUR_API_KEY" \\
  -F "files=@screenshot.png" \\
  -F "files=@receipt.pdf"

{
  "files": [
    { "type": "image", "path": "https://api.vangardpay.com/uploads/appeals/appeal-123.png",
      "mime_type": "image/png", "originalName": "screenshot.png", "size": 245760 },
    { "type": "document", "path": "https://api.vangardpay.com/uploads/appeals/appeal-456.pdf",
      "mime_type": "application/pdf", "originalName": "receipt.pdf", "size": 102400 }
  ],
  "message": "Загружено 2 файл(ов)"
}

curl -X GET "https://api.vangardpay.com/api/appeals?page=1&limit=10" \\
  -H "X-API-Key: YOUR_API_KEY"

{
  "data": [{
    "id": "appeal-uuid-123", "orderId": "a1b2c3d4",
    "reason": "Платёж не зачислен", "status": "PENDING",
    "deadline": "2026-03-19T18:00:00.000Z",
    "createdAt": "2026-03-16T18:00:00.000Z",
    "order": {
      "id": "a1b2c3d4", "invId": "ORDER_123", "amount": 5000,
      "status": "CANCELLED",
      "merchant": { "id": "m-abc", "displayName": "My Store" },
      "trader": { "id": "t-xyz", "name": "Трейдер 1" },
      "requisite": { "id": "req-uuid", "method": "SBP",
        "cardNumber": null, "sbpPhoneNumber": "+79991234567",
        "bank": { "id": "bank-uuid", "name": "Сбербанк" }
      }
    }
  }],
  "meta": { "total": 3, "page": 1, "limit": 10, "totalPages": 1 }
}

curl -X GET https://api.vangardpay.com/api/appeals/APPEAL_UUID \\
  -H "X-API-Key: YOUR_API_KEY"

{
  "id": "appeal-uuid-123",
  "orderId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "reason": "Платёж не зачислен", "comment": "Клиент отправил 5000 руб",
  "status": "PENDING",
  "images": "["https://api.vangardpay.com/uploads/appeals/appeal-123.jpg"]",
  "videos": null, "documents": null,
  "deadline": "2026-03-19T18:00:00.000Z",
  "createdAt": "2026-03-16T18:00:00.000Z",
  "order": {
    "id": "a1b2c3d4", "invId": "ORDER_123", "amount": 5000,
    "currency": "RUB", "status": "CANCELLED", "type": "DEPOSIT",
    "bank": "SBERBANK", "createdAt": "2026-03-16T17:00:00.000Z",
    "merchant": { "id": "m-abc", "displayName": "My Store" },
    "trader": { "id": "t-xyz", "name": "Трейдер 1" },
    "requisite": { "id": "req-uuid", "method": "SBP",
      "cardNumber": null, "sbpPhoneNumber": "+79991234567",
      "bank": { "id": "bank-uuid", "name": "Сбербанк" } }
  },
  "changeLogs": [
    { "id": "log-1", "status": "PENDING", "comment": null, "createdAt": "2026-03-16T18:00:00.000Z" }
  ]
}

webhook Вебхуки

При каждом изменении статуса ордера VangardPay отправляет POST-запрос на ваш callbackUrl. Формат: application/json. Заголовок: User-Agent: PaymentAggregator/1.0.

Формат вебхука

{
  "invId": "ORDER_123",
  "status": "COMPLETED",
  "amount": 5000,
  "factAmount": 4997.50,
  "currency": "RUB",
  "timestamp": "2026-03-16T18:15:00.000Z",
  "signature": "a1b2c3d4e5f6..."
}

Проверка подписи (HMAC-SHA256)

Подпись вычисляется из конкатенации 4 полей + ваш callbackSecret:

dataString = invId + status + amount + timestamp
signature  = HMAC-SHA256(dataString, callbackSecret)

Пример на Node.js:

const crypto = require('crypto');

app.post('/webhook', (req, res) => {
  const { invId, status, amount, timestamp, signature } = req.body;

  const dataString = invId + status + amount + timestamp;
  const expected = crypto
    .createHmac('sha256', CALLBACK_SECRET)
    .update(dataString)
    .digest('hex');

  if (expected !== signature) {
    return res.status(403).json({ error: 'Invalid signature' });
  }

  // Обработка события
  switch (status) {
    case 'COMPLETED':
      // Зачислить средства пользователю
      break;
    case 'CANCELLED':
    case 'EXPIRED':
    case 'FAILED':
      // Уведомить пользователя об ошибке
      break;
  }

  res.json({ ok: true });  // Обязательно ответить 200!
});

Пример на PHP:

$data = json_decode(file_get_contents('php://input'), true);

$dataString = $data['invId'] . $data['status'] . $data['amount'] . $data['timestamp'];
$expected = hash_hmac('sha256', $dataString, $callbackSecret);

if (!hash_equals($expected, $data['signature'])) {
    http_response_code(403);
    exit('Invalid signature');
}

// Обработка событие
if ($data['status'] === 'COMPLETED') {
    // Зачислить средства
}
http_response_code(200);
echo json_encode(['ok' => true]);

Пример на Python:

import hmac, hashlib, json
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhook', methods=['POST'])
def webhook():
    data = request.json
    data_string = f"{data['invId']}{data['status']}{data['amount']}{data['timestamp']}"
    expected = hmac.new(
        CALLBACK_SECRET.encode(),
        data_string.encode(),
        hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(expected, data['signature']):
        return jsonify(error='Invalid signature'), 403

    if data['status'] == 'COMPLETED':
        # Зачислить средства
        pass

    return jsonify(ok=True), 200

Ожидаемый ответ

Ваш сервер обязан ответить HTTP 200 OK с любым телом. Все остальные коды считаются ошибкой.

Политика повторов

Идемпотентность

Статусы ордеров

error Коды ошибок

Все ошибки API возвращаются в унифицированном формате с типизированным errorCode:

{
  "statusCode": 400,
  "errorCode": "ORDER_CANCEL_INVALID_STATUS",
  "message": "Невозможно отменить ордер в статусе COMPLETED",
  "details": null,
  "timestamp": "2026-03-18T12:00:00.000Z",
  "path": "/api/v1/orders/uuid/cancel"
}

Ордера

Апелляции

Общие