Общие настройки мерчантов

Большинство настроек, указанных в разделе, используются во всех разработанных модулях для мерчантов. Некоторые мерчанты имеют особенные параметры, которые будут рассмотрены непосредственно в инструкциях по настройке этих мерчантов.

Настройки модуля

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

Настройки

Обратите внимание, что при использовании некоторых модулей мерчантов необходимо создать для каждой фиатной валюты/криптовалюты/сети криптовалюты. В каждой копии необходимо выбрать/указать соответствующий пункт (это поле для заполнение или выпадающий список "Сеть"/"Способ оплаты"/"Тип транзакции"), а затем подключить копию этого модуля на вкладке "Мерчанты и выплаты" в настройках направления обмена, где в валюте "Отдаю" используется указанная валюта.

Если в настройках модуля мерчанта отображается поле "Примечание для платежа" — обязательно заполните его текстом ID заявки: [exchange_id] или просто [exchange_id].

Это необходимо для привязки заявки к транзакции по ней у самого мерчанта — без указания этого шорткода не будет меняться статус заявки.

В разделе ниже указываются общие настройки для работы мерчанта.

  • Инструкция по оплате для пользователя - укажите рекомендации по оплате для пользователя, которые будут отображаться ему на странице с кнопкой "Перейти к оплате"

Подходящий текст для поля "Инструкция по оплате для пользователя":

<h2>Произведите оплату на выданные реквизиты</h2>

[textblock]<h3>[copytext][to_account][/copytext][breakword] [dest_tag]

[copytext][sum1c][/copytext] [currency_code_give]</h3>[/textblock]

[qr_code size="200"][to_account][/qr_code]

Шорткод [breakword] в данном случае корректно разобьёт длинный (от 30 символов) номер кошелька [to_account] — к примеру, по криптовалюте Monero (XMR)

  • Примечание для платежа — если данное поле отображается в настройках модуля мерчанта, обязательно заполните его, которое будет передаваться мерчанту. Примечание платежа выглядит так: Заявка [exchange_id]

  • Погрешность суммы платежа при необходимости укажите погрешность (абсолютное значение в валюте платежа или % от суммы из заявки), в этом случае мерчант будет проверять сумму оплаты от пользователя с заданной погрешностью (в меньшую сторону)

Пример 1: Задана погрешность 0,5. Пользователь должен оплатить 50 USDT, но по ошибке оплатил 49,9 USDT. При проверке мерчантом данный платеж будет засчитан, т.к. недоплата составила 0,1 USDT, что укладывается в рамки заданной погрешности 0,5.

Пример 2: Задана погрешность 1,5%. Пользователь должен оплатить 1000 DOGE, но по ошибке оплатил 990 DOGE. При проверке мерчантом данный платеж будет засчитан, т.к. недоплата составила 10 DOGE, что укладывается в рамки заданной погрешности 1,5% (1000*1,5%=15 DOGE).

  • Суточный лимит для мерчанта при необходимости установите суточный лимит на прием средств для мерчанта. Мерчант не сможет принять оплату больше заданного лимита. Указывается в валюте, которую планируете принимать.

Если вы планируете использовать опции для установки лимитов и/или мин/макс сумм выплаты, а для приема различных валют используется один модуль мерчанта, то необходимо создать копии модуля под каждую валюту

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

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

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

  • Дневной лимит заявок (количество) для мерчанта количество выполненных заявок, которое можно создать в течение суток

  • Скрыть кнопку "Отменить заявку": Да — убрать кнопку на странице заявки для клиента Нет — отобразить кнопку

  • Сумма оплаты для пользователя — сумма, которая будет отображаться пользователю при создании заявки: сумма Отдаете (доп. ком.) сумма Отдаете (с доп. ком. и комиссией ПС) сумма для резерва сумма Отдаете

  • Сумма ожидаемая к зачислению сумма, которая ожидается к зачислению на счет мерчанта: сумма Отдаете (доп. ком.) сумма Отдаете (с доп. ком. и комиссией ПС) сумма для резерва сумма Отдаете

  • Разрешенные IP адреса (с новой строки) задайте IP-адрес(а) платежной системы, которым будет разрешен доступ к статусному URL мерчанта. На данный URL платежная система присылает информацию о платеже. Если задать разрешенные IP-адреса, это повышает безопасность работы с мерчантом.

IP-адрес(а) платежной системы, с которых она присылает информацию о платеже на статусный URL, можно узнать в технической поддержке платежной системы

  • Хэш Cron файла задайте хэш, который дополнит URL задания Cron (набор произвольных 20-40 латинских букв и цифр)

Не забудьте создать задание Cron на сервере для проверки платежа — инструкция по настройке

  • Хэш для Status/Result URL задайте хэш, который дополнит статусный URL мерчанта. На данный URL платежная система присылает информацию о платеже. Если задать хэш, статусный URL становится уникальным, что повышает безопасность работы с мерчантом. Рекомендуем использовать хэш длиной не менее 20 символов, содержащий латинские буквы и цифры. Пример хэша — ImYkwGsq2fjhuWypiasq2fNasq2fdQJzVvCpiasq2fdQJzVvCpis8umbxs8umbx

Если в настройках конкретного модуля мерчанта или автовыплаты отображается строка со Status URL/Callback URL, но нет упоминания о нём в инструкции по настройке самого модуля — можете игнорировать этот URL (работа с ним происходит на уровне кода без настройки администратором) При настройке мерчанта на стороне платежной системы в качестве статусного адреса (как правило это Status URL или Return URL) указывайте URL уже с заданным хэшем!

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

Работа со статусами заявок

В этом разделе настраивается работа мерчанта для определенных правил перехода заявки по статусам.

  • Номер счета с которого была сделана оплата не совпадает с указанным в заявке при несовпадении счета можно перевести заявку в другой статус или оставить имеющийся: оставлять статус заявки "Новая заявка" изменять статус заявки на "На проверке" изменять статус заявки на "Оплаченная заявка"

  • Сумма платежа меньше чем требуется если пользователь совершил транзакцию на меньшую сумму, чем указано в заявке, можно перевести заявку в другой статус или оставить имеющийся: оставлять статус заявки "Новая заявка" изменять статус заявки на "На проверке" изменять статус заявки на "Оплаченная заявка"

  • Сумма платежа больше чем требуется если пользователь совершил транзакцию на большую сумму, чем указано в заявке, можно перевести заявку в другой статус или оставить имеющийся: оставлять статус заявки "Новая заявка" изменять статус заявки на "На проверке" изменять статус заявки на "Оплаченная заявка"

  • Приоритет укажите приоритет от 1 до 10 (где: 0 или пустое поле — отсутствие приоритета или последний модуль по использованию, с 1 по возрастанию — рост приоритета использования (0<1<2<3<...<n)), если в направлении обмена используются несколько модулей мерчантов

Наиболее подходящий мерчант для конкретной заявки выбирается автоматически с учетом приоритета. Мерчант не может быть заменен, если уже был использован в заявке

Подключение нескольких мерчантов

Начиная с версии 2.6, доступна опция замены мерчанта, если от него не удалось получить реквизиты для оплаты по каким-либо причинам (ошибки на стороне сервиса, ошибка авторизации в модуле, отсутствие доступных реквизитов у мерчанта и т.п.).

Доступные следующие варианты (раздел "Настройки обменника" -> "Основные настройки":

Если вы хотите продолжить использовать логику из версии 2.5, то выберите пункт "Подключить мерчант"

  • Подключить мерчант — после неудачной попытки получения реквизитов заявка останется в статусе "Новая заявка", вместо шорткода [to_account] будет отображен текст из поля "Текст ошибки, если счёт не указан"

  • Перевести заявку в ошибку мерчанта — после неудачной попытки получения реквизитов заявка перейдет в статус "Ошибка мерчанта"

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

Если в направлении обмена подключен только один мерчант и используется вариант "Попробовать подключить другой мерчант" с заполненным шаблоном для поля "Текст ошибки, если счёт не указан", то заявка останется в статусе "Новая заявка", вместо шорткода [to_account] будет отображен текст из поля "Текст ошибки, если счёт не указан")

  • Показать QR код на странице оплаты — отображение QR-кода при переходе к оплате на странице заявки НетДа

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

Не используйте опцию "Персональная настройка статусов, которые можно принимать" без необходимости!

Если не выбран ни один из пунктов, то мерчант работает со статусами по умолчанию. Если выбрать статусы из списка, то мерчант будет работать только с выбранными статусами.

  • Назначить заявке статус ошибки, в случае ошибки API при ошибке ответа со стороны мерчанта, присваивать заявке статус ошибки: Нет Да

Начиная с версии 2.6, доступна опция замены текста на кнопке перехода на платежную страницу мерчанта, если по каким-то причинам мерчант (Bitconce Link, Firekassa Link и др.) не смог предоставить реквизиты для оплаты

Настройки прокси (использовать только при необходимости)

В этом разделе указывается определенный IP-адрес, если нет доступа к мерчанту с обычного IP-адреса.

  • IP адрес адрес прокси-сервера

  • Порт порт прокси-сервера

  • Логин ваш логин для доступа к прокси-серверу

  • Пароль — ваш пароль для доступа к прокси-серверу

  • Отключить прокси туннель отключение опции при заполненных выше полях Нет Да

Last updated