BoxExchanger
  • Вернутся на сайт
  • Начало работы
    • Настройка безопасности
      • Создание админа
      • Настройка прав администратора (роли)
      • Установка двухфакторной аутентификация
      • Ограничения доступа админ панели по IP
        • Установка ограничения на CloudFlare
        • Установка ограничений в админ панели
      • Установка ограничение по header host
    • Настройка дизайна
    • Технические работы
    • Уведомление на сайте
      • Создание
      • Редактирование
    • Избраные курсы
      • Создание
      • Редактирование
    • Подключение онлайн чата
      • Подключение чата LiveChat
      • Подключение чата JivoSite
      • Подключение чата HelpCrunch
    • Добавление контактов
    • Настройка почты
      • Отправка копии отправленных писем
      • Подключение GMail почты
      • Подключение Zoho почты
      • Подключение dynadot почты
    • Вопросы и ответы
      • Создать
    • Настройка AntiBot системы
      • Установка reCAPTCHA
    • Правила
      • Создание
      • AML/KYC Политика
    • Партнеры
      • Создание партнера
      • Редактирование
    • Новости
      • Создание
    • Отзывы
      • Создать
      • Список отзывов
    • Статичные страницы
      • Создание
    • Настройки авторизации пользователя
    • Настройка идентификаторов
    • Настройка истории действий
  • Обмен
    • Валюты
      • Список валют
      • Логотип валюты
      • Название валюты
      • Тип валюты
      • Точность суммы
      • XML валюты
      • Курс к USD
      • Резервы
      • Настройка поля валюты
      • Прием платежей
      • Настройка выплаты
      • AML проверка
      • Верификация
    • Сортировка направлений
    • Направление
      • Приоритетные модули
      • Плавающий курс
      • Страховка курса
      • SEO-friendly URL (ЧПУ)
      • Документы
      • Дополнительные услуги
    • Настройка группы направлений
    • Мерчант и АПИ
      • 001k bot
        • Мерчант 001k bot
        • Выплаты 001k bot
      • Биржа whitebit
        • Взаимодействие модулей
        • Мерчант whitebit
        • Выплаты whitebit
      • BetPay
        • Мерчант BetPay
        • Выплаты BetPay.money
      • Heleket
        • Мерчант Heleket
        • Выплаты Heleket
      • Paylink.finance
        • Мерчант Paylink.finance
        • Выплаты Paylink.finance
      • VelPay
        • Выплаты VelPay
      • Мерчант BSC BEP20
      • Мерчант Billline
      • Мерчант Bitconce
      • Мерчант By password
      • Мерчант Dynamic requisites
      • Мерчант EVM Token
      • Мерчант ETH ERC20
      • Мерчант TRON TRC20
      • Мерчант Monerod
      • Мерчант Payeer
      • Мерчант Perfect Money
      • Мерчант WestWallet.io
      • Настройка Inqud
      • Выплаты Agents Telegram
      • Выплаты Auto Success
      • Выплаты Binance
      • Выплаты Kuna.io
      • Выплаты PSPline
      • Выплаты WestWallet.io
    • Парсер курсов
      • BestChange v2
      • BetPay.Money
      • CurrencyLayer
      • Heleket
      • Kurs.Expert
      • PancakeSwap
      • Paylink.finance
      • VelPay
      • whitebit v2
      • XML file
    • Верификации
    • Расчет суммы обмена
  • Заявки
    • Список обменов
    • Заявки
      • Статусы заявки
    • Автоматическое добавление резерва
  • Партнерская программа
    • Партнерские направления
    • Партнёрские обмены
    • Реферальные настройки
  • AML плагины
    • CUBE3
    • CrystalBlockchain
    • AMLBot.com
    • GetBlock.net
  • Дополнительные системы
    • Внутренний кошелек
    • Расписания
    • Approve underpaid orders
    • Heleket модули
      • Heleket auto update fee
      • Heleket control available
      • Heleket auto min amount for TO currency
    • Install plugin
    • KYC модули
      • KYC Модуль Kycaid
      • KYC Модуль AMLBot
      • KYC Модуль SumSub
    • Whitebit модули
      • WhiteBit Exchanger auto update fee
      • WhiteBIT control available
      • WhiteBIT auto min amount for TO currency
    • BestChange ScamAPI
  • Системы авторизации
    • Авторизация Apple
    • Авторизация Google
  • Для разработчиков
    • Установка проекта
      • Сервер для обменника
        • Vultr
        • DigitalOcean
          • Удаление VDS на DigitalOcean
        • Hetzner Cloud
          • Изменения размера VDS на Hetzner
          • Удаление VDS на Hetzner
      • Настройки CloudFlare
      • Установка Nginx
      • Установка ПО
        • Установка NodeJs
        • Установка MongoDB
        • Установка exchanger-api
        • Установка exchanger-web
        • Настройка сборки на CloudFlare Workers
    • Настройка Telegram Bot
    • Доступ к исходному коду
    • Миграция Git BoxExchanger
    • Разработка client-web
      • Локальный запуск
      • Применения изменений
    • Шаблоны писем
      • Локализация шаблонов
    • Загрузка статического файла
    • Структура проекта
    • Настройки API документации
    • Установка Node
      • Bitcoin Node
      • Monero Node
      • Ethereum Node
      • Tron Node
    • Разработка модулей
      • Мерчант системы
      • Модуль выплат
      • Парсер курсов
    • Отправка логов разработчикам
    • Процессинг платежей API
    • Настройка VPN (openvpn)
    • Установка SOCKS5-прокси
    • Настройка бекап на B2
    • Настройка Firewall
      • Настройка доступа порта 22 (ssh)
      • Настройка доступа портов 80,443 (http/s)
      • IP в белый список CloudFlare
    • Webhook уведомления URL
      • Новый обмен
      • Новая верификация (ручная)
      • Обновление статуса заявки
      • Регистрация пользователя
  • Журнал изменений
Powered by GitBook
On this page
  • Создать заявку
  • IPN (Уведомление об изменении статуса платежного запроса)
  • Список статусов
  • Верефикация контрольной суммы запроса (IPN)
  • Контроль платежей
  • Оплата

Was this helpful?

  1. Для разработчиков

Процессинг платежей API

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

Last updated 3 years ago

Was this helpful?

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

Используйте метод public/exchanger/order/create

Название
Описание
Тип

routeId

id направления

ObjectID

partner

код партнера

STRING

amount

сумма

FLOAT

fromValues[0][key]

ключ поля

ObjectID

fromValues[0][value]

значение для поля

STRING

toValues[0][key]

ключ поля

STRING

toValues[0][value]

значение для поля

STRING

routeValues[0][key]

ключ поля

ObjectID

routeValues[0][value]

значение для поля

STRING

lang

язык (рус, англ)

STRING

agreement

cоглашение

BOOLEAN

hideOutData

cкрыть реквизиты

BOOLEAN

clientCallbackUrl

обратный вызов, когда приложение будет завершено, клиент увидит кнопку для возврата на сайт, и клиент будет перенаправлен на этот url ?status=success или на ?status=error

STRING

ipnUrl

URL-адрес уведомления о мгновенном платеже (будет вызыван, присмене статуса ордера)

STRING

ipnSecret

строка для создания безопасного хеша в ipn url

STRING

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

IPN (Уведомление об изменении статуса платежного запроса)

Чтобы получать уведомление об изменении статуса заявки при её создании, вам необходимо отправить дополнительные параметры:

  • clientCallbackUrl - обратный вызов, когда приложение будет завершено, клиент увидит кнопку для возврата на сайт, и клиент будет перенаправлен на этот url

  • hideOutData - скрыть данные получателя

  • ipnUrl - Ссылка HTTP / HTTPS для уведомления вашего сервера.

  • ipnSecret - Случайная строка для создания подписи запроса (для поддержания целостности запроса)

  1. Запрос будет отправлен методом POST

  2. IPN будет отправлено один раз

  3. Доставка IPN не гарантируется (если сервер не ответил на запрос, он не будет отправлен повторно)

Пример IPN

  • POST

  • ['Content-Type'] = 'application/x-www-form-urlencoded'

  • orderUID :Number() - заявка uid

  • orderId :String(ObjectId) -заявка id

  • newStatus :String() - заявка текущего статуса

  • inAmount :String(number) - order in sum

  • outAmount :String(number) - order out sum

  • xml_from :String() - заявка uid

  • xml_to :String() - заявка uid

  • timestamp :Number() - unix время и ipn уведомления

  • toValues :Array([{key,name,value}]) - реквизиты заявки

Список статусов

  • new - новая заявка

  • waitPayment - ожидаем платеж от пользователя

  • errorPayment - ошибка пользовательского платежа (ошибка отправки продавца)

  • inProgress - в процессе (ожидается обработка админом или оплата заявки)

  • inProgressPayout - в очереди на оплату (платеж принят успешно) (если настроен автоматический платеж в валюте, он будет инициализирован)

  • errorPayout - ошибка платежа (ошибка произошла при оплате)

  • hold - заявка заморожена (проблемы с приложением)

  • done - заявка успешно выплачена

  • returned -заявка была оплачена, но не все условия обмена и способы возврата отправителя были выполнены

  • deleted - заявка удалена (отменена)

Верефикация контрольной суммы запроса (IPN)

sha256(orderId:newStatus:inAmount:outAmount:xml_from:xml_to:timestamp:ipnSecret)

        
const stringForHash = orderId+":"+newStatus+":"+inAmount+":"+outAmount+":"+xml_from+":"+xml_to+":"+timestamp+":"+ipnSecret;
// example string for hash 5d8e6002b80b7b4cd75a6424:inProgress:2:317.42:ETH:WMZ:1571328406072:SECRET123

const hash = crypto.createHash('sha256').update(stringForHash).digest('hex')
// example hash af3acf947e6f0e0f2c267e300b8582e504dba12d1f2d058652b7414163c09f48
        
      

Контроль платежей

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

  2. Вы можете сохранить UID запроса и секрет и вручную перейти к запросу, указав эти данные в адресной строке

Оплата

  1. Вы можете использовать / payment / для отображения страницы оплаты // schema protocol://domain/user-lang/payment/order-uid/order-secret // example result https://www.domain.com/en/payment/1409/dGqwF2M2eBPaSN1G5ljMS1cb

  2. Также вы можете просто отбразить ссылку на бирже так, как ее видят все клиенты по той же схеме, что и в первом варианте, кроме /payment/ следует заменить на /order/

  3. В методе есть параметры, которые позволяют отображать платежные данные или форму оплаты на вашем сайте, которую вы можете использовать. ВАЖНО: если используется метод с предоплатой, вам необходимо обновить статус заказа с waitPayment до inProgress после оплаты.