Перейти к основному содержимому

Субмерчанты

Принимайте платежи от имени нескольких мерчантов через одну интеграцию с Volet.com.

Поддержка субмерчантов позволяет платформам строить собственные платёжные продукты на базе Volet.com. Вместо того чтобы подключать к Volet.com каждого мерчанта напрямую, платформа интегрируется один раз и обрабатывает платежи от имени своих мерчантов.

Клиенты по-прежнему платят через вашу платформу или ваших субмерчантов, а ваша платформа остаётся единой точкой интеграции с Volet.com.

Каждый платёж можно связать с конкретным субмерчантом, чтобы платформа могла идентифицировать платёж, отслеживать заказы и проводить расчёты по своей бизнес-логике.

Типичные сценарии:

  • White-label платёжные провайдеры
  • Агрегаторы мерчантов
  • Маркетплейсы
  • Платформы для авторов
  • SaaS-платформы, обслуживающие много мерчантов

Как это работает​

Платформа один раз интегрируется с Volet.com и принимает платежи от имени нескольких субмерчантов.

Общий порядок платежа:

  1. Ваша платформа создаёт платёжный запрос от имени субмерчанта.
  2. Ваша платформа передаёт в платёжном запросе данные субмерчанта.
  3. Клиент завершает платёж через Hosted Checkout, ваш собственный платёжный интерфейс на API или через смарт-контракт.
  4. Средства поступают в соответствии с выбранной платёжной моделью.
  5. Ваша платформа сопоставляет завершённый платёж с заказом соответствующего субмерчанта.
  6. Ваша платформа рассчитывается с субмерчантом на своих коммерческих условиях.

Модели интеграции​

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

Hosted Checkout​

Hosted Checkout даёт готовый платёжный интерфейс и при этом позволяет платформе связывать каждый платёж с конкретным субмерчантом.

При создании платёжного запроса Hosted Checkout можно передать сайт субмерчанта в параметре ac_submerchant_url.

Пример:

<input type="hidden" name="ac_submerchant_url" value="https://seller.example.com">

Также можно передать собственные поля, например:

  • ID субмерчанта
  • ID продавца
  • ID заказа на маркетплейсе
  • Внутренний номер счёта
  • ID клиента

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

Подробнее — в разделе Интеграция Hosted Checkout.

API вместе с Hosted Checkout​

API и Hosted Checkout можно сочетать в одном платёжном сценарии.

API отвечает за создание платёжного инвойса, а Hosted Checkout предоставляет клиенту платёжный интерфейс.

В этой модели платформа создаёт криптоинвойс через API и связывает его с заказом субмерчанта, а затем перенаправляет клиента на Hosted Checkout.

В отличие от стандартного сценария Hosted Checkout, платёжный инвойс создаёт ваша платформа, а не Hosted Checkout. Hosted Checkout лишь показывает страницу оплаты для уже существующего инвойса и проводит клиента через оплату.

Такой подход позволяет платформе:

  • Связать платёж с субмерчантом до того, как клиент начнёт оплату.
  • Сохранить собственную логику управления заказами и инвойсами.
  • Не разрабатывать и не поддерживать платёжный интерфейс ни для платформы, ни для субмерчантов.
  • Поручить Volet.com платёжные инструкции, QR-коды, мониторинг блокчейна и обновление статусов платежей.

Без Hosted Checkout тот же сценарий можно полностью реализовать через API. В этом случае платформа или каждый субмерчант должны предоставлять клиентам собственный платёжный интерфейс.

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

См.:

Платежи через смарт-контракты​

Платформы также могут поддерживать субмерчантов с помощью некастодиальных платежей через смарт-контракты.

В этой модели клиенты платят напрямую со своих кошельков, а платёж выполняется в блокчейне смарт-контрактом.

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

Типичные сценарии:

  • Распределение дохода
  • Распределение комиссий маркетплейса
  • Платежи нескольким получателям
  • Прямые расчёты между кошельками
  • Собственная платёжная логика

Подробнее — в разделе Распределение дохода.

Отслеживание платежей субмерчантов​

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

Распространённые идентификаторы:

  • ID субмерчанта
  • Сайт субмерчанта
  • ID заказа на маркетплейсе
  • Внутренний ID счёта
  • ID клиента
  • ID пакета расчётов

Для Hosted Checkout можно использовать параметр ac_submerchant_url и собственные поля.

Для сценариев с криптоинвойсами через API храните ID криптоинвойса вместе с заказом на платформе и записью о субмерчанте.

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

Расчёты с субмерчантами​

При кастодиальных сценариях полученные средства зачисляются на аккаунт Volet.com основного мерчанта.

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

Рассчитаться с субмерчантами можно одним из способов:

  • Перевести криптовалюту на криптокошелёк.
  • Перевести средства на аккаунт Volet.com субмерчанта.
  • Отправить банковский перевод вручную из интерфейса аккаунта, где это доступно.
примечание

Банковские переводы субмерчантам сейчас недоступны через API. Если для расчётов нужен банковский перевод, его нужно отправить вручную из интерфейса аккаунта.

Платформа также может удержать свою комиссию, прежде чем перевести оставшуюся сумму субмерчанту.

Например:

  1. Клиент платит 100 USDT.
  2. Ваша платформа получает платёж.
  3. Ваша платформа удерживает комиссию 10 USDT.
  4. Ваша платформа переводит субмерчанту 90 USDT.

Комплаенс и проверка​

Обработка платежей субмерчантов подлежит проверке.

Ваша платформа отвечает за то, чтобы знать, кто её субмерчанты, какие товары или услуги они предоставляют и допускается ли их деятельность правилами Volet.com.

примечание

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

Перед подключением или одобрением интеграции Volet.com может запросить сведения о вашей модели работы с субмерчантами, процессе их подключения, категориях бизнеса, сайтах, потоках транзакций и логике расчётов.

Как подключить​

Шаг 1. Свяжитесь с нами​

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

Свяжитесь с нашей командой и расскажите:

  • О модели вашей платформы
  • О типах субмерчантов, которых вы поддерживаете
  • Об ожидаемых платёжных методах
  • Об ожидаемой схеме расчётов

Наша команда поможет выбрать подходящую модель:

  • Hosted Checkout — для готового платёжного интерфейса.
  • API вместе с Hosted Checkout — для заранее созданных криптоинвойсов и платёжного интерфейса Hosted Checkout.
  • Только API — если платформа предоставляет собственный платёжный интерфейс.
  • Смарт-контракты — для некастодиальных сценариев и собственной логики расчётов в блокчейне.

Шаг 2. Настройте приём платежей​

Если вы используете Hosted Checkout, API или API вместе с Hosted Checkout, создайте и настройте платёжный шлюз в аккаунте Volet.com.

Шлюз определяет, как принимаются платежи, какие платёжные методы включены и как обрабатывается информация о статусе платежей.

См.:

Если вы используете платежи через смарт-контракты, наша команда вместо этого предоставит нужную настройку смарт-контракта.

Шаг 3. Реализуйте интеграцию​

Реализуйте платёжный сценарий, который соответствует выбранной модели интеграции.

Подробности реализации:

Шаг 4. Настройте данные субмерчантов и сопоставление заказов​

Определите, как платформа будет передавать, хранить и сопоставлять информацию о субмерчантах.

Шаг 5. Проверьте платежи и расчёты​

Перед запуском проверьте:

  • Создание платежа
  • Идентификацию субмерчанта
  • Обработку статуса платежа
  • Сопоставление заказов
  • Расчёт комиссии
  • Расчёты с субмерчантом
  • Сценарии неудачных и отменённых платежей

Шаг 6. Запуск​

Когда интеграция одобрена, настроена и проверена, платформа может начинать принимать платежи от имени субмерчантов.

Ограничения​

  • За расчёты с субмерчантом отвечает ваша платформа.
  • Расчёты с субмерчантами банковским переводом недоступны через API.
  • Некоторые бизнес-модели субмерчантов могут потребовать дополнительной комплаенс-проверки перед активацией.