VangardPay — Merchant Portal 1.0

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

menu_book VangardPay — Merchant Portal
├── rocket_launch Быстрый старт
├── work Личный кабинет
│ ├── Депозит (ввод USDT)
│ ├── История операций
│ ├── Финансовая отчётность
│ └── Портал апелляций
├── balance Апелляции
│ ├── Типы апелляций
│ ├── Требования к доказательствам
│ ├── Процедура рассмотрения
│ └── Сроки (SLA)
├── currency_exchange Расчёты и конвертация
│ ├── Курсообразование
│ └── Формула начислений
├── gavel Правила и ответственность
│ ├── Условия сотрудничества
│ ├── Комплаенс-требования
│ └── Защита от парсинга
├── integration_instructions API Reference
│ ├── Аутентификация
│ ├── Баланс
│ ├── Pay-In
│ ├── Pay-Out
│ ├── Апелляции
│ └── Справочники
└── edit_note Changelog

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

Добро пожаловать в VangardPay. Ниже — пять шагов, чтобы начать принимать платежи.

work Merchant Dashboard

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

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

История операций(CTO, переделай под наши поля)

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

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

• Тип операции: все / входящие / исходящие
• Сортировка: по ID, дате, сумме

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

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

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

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

1. Откройте Dashboard → Отчётность
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.

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

1. Получите API-ключ у администратора VangardPay
2. Добавьте X-API-Key заголовок ко всем запросам
3. Создайте первый ордер через POST /api/orders/create
4. Настройте вебхуки для получения уведомлений о статусах

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

Все ответы возвращаются в формате JSON. При ошибке возвращается объект:

{
  "statusCode": 400,
  "errorCode": "BAD_REQUEST",
  "message": "Описание ошибки",
  "timestamp": "2026-01-01T00:00:00.000Z"
}

Подпись вебхуков

Для верификации подлинности вебхуков проверяйте заголовок X-Signature:

signature = sha256(invId + status + amount + timestamp, callbackSecret)

Пример проверки на Node.js:

const crypto = require('crypto');
const expected = crypto
  .createHmac('sha256', callbackSecret)
  .update(invId + status + amount + timestamp)
  .digest('hex');
const isValid = expected === receivedSignature;

key Authentication

Авторизация и управление сессиями

curl -X POST https://api.vangardpay.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "merchant@example.com", "password": "your_password"}'

currency_exchange Exchange Rates

Актуальные курсы и конвертация валют

curl -X GET "https://api.vangardpay.com/api/exchange-rates/rate?from=USDT&to=RUB" \
  -H "X-API-Key: YOUR_API_KEY"

account_balance_wallet Balance

Баланс, пополнения, выводы и история операций

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

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

storefront Merchants

Профиль мерчанта

gavel Appeals

Создание и отслеживание апелляций

curl -X POST https://api.vangardpay.com/api/appeals \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId": "ORDER_ID", "reason": "Описание проблемы"}'

payments Currencies

Справочник поддерживаемых валют

account_balance Banks

Справочник доступных банков

receipt_long Orders

Создание и управление платёжными ордерами

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

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