Эквайринг InvoiceBox для micro-mobility.ru

Что такое InvoiceBox

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

В отличие от стандартных эквайрингов, InvoiceBox заточен под работу с бизнес-клиентами (B2B). Можно выставлять счета на оплату, принимать платежи по номеру заказа, работать с несколькими валютами.

Задача

Магазин micro-mobility.ru — дистрибьютор продукции Micro. Продают как физическим лицам (B2C), так и юридическим (B2B): магазинам, оптовым покупателям.

Нужно было подключить способ оплаты, который поддерживает:

Оплату картой для физических лиц
Выставление счетов для юридических лиц
Оплату в разных валютах (евро, доллары, юани)
Автоматическую синхронизацию статусов оплаты

Что реализовали

Создание платежной ссылки

Разработали приложение, которое создает ссылку на платежный шлюз InvoiceBox. В ссылку передаются:

Номер заказа
Назначение платежа
Список товаров с ценами
Сумма с учетом скидок и промокодов
Итоговая стоимость заказа
Контактные данные покупателя

Выбор варианта оплаты

На странице InvoiceBox покупатель видит варианты оплаты:

Оплата картой — для физических лиц, мгновенная оплата
Счет на оплату — для юридических лиц, оплата по реквизитам
Валюта — рубли, евро, доллары, юани

Автоматическая синхронизация статусов

После оплаты InvoiceBox отправляет уведомление на сервер магазина. Система автоматически меняет статус заказа в InSales на "Оплачен".

Если оплата не прошла или была отменена — статус остается "Ожидает оплату".

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

Покупатель оформляет заказ на сайте
Выбирает способ оплаты "Оплатить картой через InvoiceBox"
Нажимает "Оформить заказ"
Переходит на страницу InvoiceBox
Выбирает вариант оплаты (карта или счет)
Оплачивает заказ
InvoiceBox отправляет уведомление магазину
Статус заказа автоматически меняется на "Оплачен"
Покупатель получает подтверждение по email

Возможности InvoiceBox

Выставление счетов

Счета можно выставлять разными способами:

На сайте — покупатель видит счет сразу после оформления заказа
В письмах — счет отправляется на email автоматически
В СМС — ссылка на оплату приходит в сообщении
Через мобильные устройства — счет открывается на телефоне

Мультивалютная оплата

InvoiceBox поддерживает оплату в разных валютах. Это важно для магазинов, работающих с иностранными клиентами.

Доступные валюты:

Рубли — для российских клиентов
Евро — для Европы
Доллары — для США и других стран
Юани — для Китая

B2B продажи

Автоматизированная система для работы с юридическими лицами. Компания заказывает товар, получает счет на оплату, оплачивает по реквизитам.

Все документы (счет, акт, накладная) можно сформировать автоматически.

Преимущества для B2B

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

Технические детали

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

Разработали модуль, который отправляет заказы на оплату в InvoiceBox и получает обратно результат оплаты.

Модуль работает как прослойка между InSales и InvoiceBox. Конвертирует данные из формата InSales в формат InvoiceBox и обратно.

Параметры передачи

При создании платежа передаем в InvoiceBox:

{
  "order_id": "12345",
  "amount": 5000,
  "currency": "RUB",
  "description": "Оплата заказа №12345",
  "items": [
    {
      "name": "Товар 1",
      "quantity": 2,
      "price": 2000
    }
  ],
  "customer": {
    "email": "customer@example.com",
    "phone": "+79991234567"
  }
}

Webhook для статусов

InvoiceBox отправляет уведомления о статусе платежа на URL, который мы указали при настройке. Сервер принимает уведомление, проверяет подпись (защита от подделки), обновляет статус заказа.

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

InvoiceBox возвращает статус оплаты в определенном формате. Модуль преобразует этот формат в формат InSales и обновляет заказ.

Статусы:

created — платеж создан, ожидает оплату
paid — платеж оплачен
cancelled — платеж отменен
refunded — деньги возвращены

Безопасность

Все платежи проходят через защищенное соединение HTTPS
Данные карт не попадают на сервер магазина
InvoiceBox сертифицирован по стандарту PCI DSS
Webhook подписывается цифровой подписью
Проверка подписи запросов от InvoiceBox

О проекте micro-mobility.ru

micro-mobility.ru — официальный дистрибьютор продукции Micro. Продают самокаты, скейтборды, средства персональной мобильности.

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

Результат

Покупатели оплачивают картой через InvoiceBox
Юридические лица получают счета на оплату
Поддержка мультивалютной оплаты (рубли, евро, доллары, юани)
Автоматическая синхронизация статусов оплаты
Выставление счетов через сайт, email, СМС
Безопасная обработка платежей по стандарту PCI DSS
Удобная работа с B2B клиентами