Общие настройки мерчантов
Last updated
Last updated
Большинство настроек, указанных в разделе, используются во всех разработанных модулях для мерчантов. Некоторые мерчанты имеют особенные параметры, которые будут рассмотрены непосредственно в инструкциях по настройке этих мерчантов.
В связи с тем, что каждый мерчант имеет свой API для авторизации, поля для раздела могут отличаться между собой — вводите полученные от мерчанта авторизационные данные согласно названию полей.
Обратите внимание, что при использовании некоторых модулей мерчантов необходимо создать для каждой фиатной валюты/криптовалюты/сети криптовалюты. В каждой копии необходимо выбрать/указать соответствующий пункт (это поле для заполнение или выпадающий список "Сеть"/"Способ оплаты"/"Тип транзакции"), а затем подключить копию этого модуля на вкладке "Мерчанты и выплаты" в настройках направления обмена, где в валюте "Отдаю" используется указанная валюта.
Если в настройках модуля мерчанта отображается поле "Примечание для платежа" — обязательно заполните его текстом ID заявки: [exchange_id] или просто [exchange_id].
Это необходимо для привязки заявки к транзакции по ней у самого мерчанта — без указания этого шорткода не будет меняться статус заявки.
В блоке ниже указываются общие настройки для работы мерчанта.
Инструкция по оплате для пользователя - укажите рекомендации по оплате для пользователя, которые будут отображаться ему на странице с кнопкой "Перейти к оплате"
Подходящий текст для поля "Инструкция по оплате для пользователя":
Шорткод [breakword] в данном случае корректно разобьёт длинный (от 30 символов) номер кошелька [to_account] — к примеру, по криптовалюте Monero (XMR)
Разумеется, вышеуказанную инструкцию вы можете скорректировать на своё усмотрение.
Примечание для платежа — если данное поле отображается в настройках модуля мерчанта, обязательно заполните его, которое будет передаваться мерчанту. Корректное примечание платежа выглядит так: Заявка [exchange_id]
Погрешность суммы платежа — при необходимости укажите погрешность (абсолютное значение в валюте платежа или % от суммы из заявки), в этом случае мерчант будет проверять сумму оплаты от пользователя с заданной погрешностью (в меньшую сторону)
Суточный лимит для мерчанта — при необходимости установите суточный лимит на прием средств для мерчанта. Мерчант не сможет принять оплату больше заданного лимита. Указывается в валюте, которую планируете принимать.
Если вы планируете использовать опции для установки лимитов и/или мин/макс сумм выплаты, а для приема различных валют используется один модуль мерчанта, то необходимо создать копии модуля под каждую валюту
Месячный лимит для мерчанта — при необходимости установите месячный лимит на прием средств для мерчанта. Мерчант не сможет принять оплату больше заданного лимита
Мин. сумма платежа для одной заявки — при необходимости установите минимальную сумму платежа для одной заявки. Мерчант не сможет принять оплату меньше заданного лимита
Макс. сумма платежа для одной заявки — при необходимости установите максимальную сумму платежа для одной заявки. Мерчант не сможет принять оплату больше заданного лимита
Дневной лимит заявок (количество) для мерчанта — количество выполненных заявок, которое можно создать в течение суток
Скрыть кнопку "Отменить заявку": • Да — убрать кнопку на странице заявки для клиента • Нет — отобразить кнопку
Сумма оплаты для пользователя — сумма, которая будет отображаться пользователю при создании заявки: • сумма Отдаете (доп. ком.) • сумма Отдаете (с доп. ком. и комиссией ПС) • сумма для резерва • сумма Отдаете
Сумма ожидаемая к зачислению — сумма, которая ожидается к зачислению на счет мерчанта: • сумма Отдаете (доп. ком.) • сумма Отдаете (с доп. ком. и комиссией ПС) • сумма для резерва • сумма Отдаете
Если мерчант берет комиссию при входящем платеже, то при выборе типа суммы ожидаемой к зачислению важно убедиться, что для вышеуказанного пункта выбран именно подходящий тип для корректной работы модуля и перевода заявку в статус "Оплаченная" при поступлении средств от клиента.
Для этого при подключенном в направлении мерчанта создайте заявку, не оплачивайте её, разверните её по кнопке "Инфо" в разделе "Заявки", выберите тот тип суммы, размер которой совпадает с одной из указанных сумм и будет зачислен на счет мерчанта после взимания комиссии.
Часто это тип суммы "Сумма для резерва" в настройках модуля мерчанта — проверьте его в первую очередь. Выберите подходящий пункт, сохраните настрйоки и оплатите заявку. Если заявка после оплаты на полную сумму перейдет в статус "Оплаченная", то настройки установлены корректно.
Разрешенные IP адреса (с новой строки) — задайте IP-адрес(а) платежной системы, которым будет разрешен доступ к статусному URL мерчанта. На данный URL платежная система присылает информацию о платеже. Если задать разрешенные IP-адреса, это повышает безопасность работы с мерчантом.
Хэш Cron файла — задайте хэш, который дополнит URL задания Cron (набор произвольных 20-40 латинских букв и цифр)
Хэш для Status/Result URL — задайте хэш, который дополнит статусный URL мерчанта. На данный URL платежная система присылает информацию о платеже. Если задать хэш, статусный URL становится уникальным, что повышает безопасность работы с мерчантом. Рекомендуем использовать хэш длиной 20-50 символов, содержащий латинские буквы и цифры. Пример хэша — ImYkwGsq2fjhuWypiasq2QJzVvCpis8umbxs8umbx
Если в настройках конкретного модуля мерчанта или автовыплаты отображается строка со Status URL/Callback URL, но нет упоминания о нём в инструкции по настройке самого модуля — можете игнорировать этот URL (работа с ним происходит на уровне кода без настройки администратором) При настройке мерчанта на стороне платежной системы в качестве статусного адреса (как правило это Status URL или Return URL) указывайте URL уже с заданным хэшем!
Режим отладки — активируйте опцию только при первоначальной настройке или при проблемах при работе с мерчантом. При включенной опции будет записываться расширенный лог мерчанта в раздел "Мерчанты" -> "Лог мерчантов": • Нет • Да
В этом блоке настраивается работа мерчанта для определенных правил перехода заявки по статусам.
Номер счета с которого была сделана оплата не совпадает с указанным в заявке — при несовпадении счета можно перевести заявку в другой статус или оставить имеющийся: • оставлять статус заявки "Новая заявка" • изменять статус заявки на "На проверке" • изменять статус заявки на "Оплаченная заявка"
Сумма платежа меньше чем требуется — если пользователь совершил транзакцию на меньшую сумму, чем указано в заявке, можно перевести заявку в другой статус или оставить имеющийся: • оставлять статус заявки "Новая заявка" • изменять статус заявки на "На проверке" • изменять статус заявки на "Оплаченная заявка"
Сумма платежа больше чем требуется — если пользователь совершил транзакцию на большую сумму, чем указано в заявке, можно перевести заявку в другой статус или оставить имеющийся: • оставлять статус заявки "Новая заявка" • изменять статус заявки на "На проверке" • изменять статус заявки на "Оплаченная заявка"
Приоритет — укажите приоритет от 1 до 10 (где: 0 или пустое поле — отсутствие приоритета или последний модуль по использованию, с 1 по возрастанию — рост приоритета использования (0<1<2<3<...<n)), если в направлении обмена используются несколько модулей мерчантов
Наиболее подходящий мерчант для конкретной заявки выбирается автоматически с учетом приоритета. Мерчант не может быть заменен, если уже был использован в заявке
В этом разделе указывается определенный IP-адрес, если нет доступа к мерчанту с обычного IP-адреса.
IP адрес — адрес прокси-сервера
Порт — порт прокси-сервера
Логин — ваш логин для доступа к прокси-серверу
Пароль — ваш пароль для доступа к прокси-серверу
Отключить прокси туннель — отключение опции при заполненных выше полях • Нет • Да
Начиная с версии 2.6, доступна опция замены мерчанта, если от него не удалось получить реквизиты для оплаты по каким-либо причинам (ошибки на стороне сервиса, ошибка авторизации в модуле, отсутствие доступных реквизитов у мерчанта и т.п.).
Доступные следующие варианты (раздел "Настройки обменника" -> "Основные настройки"):
Действие, если мерчант не сработал:
Подключить мерчант — после неудачной попытки получения реквизитов заявка останется в статусе "Новая заявка", вместо шорткода [to_account] будет отображен текст из поля "Текст ошибки, если счёт не указан" (если реквизиты от мерчанты должны отображаться в заявке)
или (начиная с версии 2.6), доступна опция замены текста на кнопке перехода на платежную страницу мерчанта, если по каким-то причинам мерчант (Bitconce Link, Firekassa Link и др.) не смог предоставить реквизиты для оплаты в виде платежной страницы (поле для текста на кнопке при получении ошибки находится в настройках используемого модуля мерчанта)
Перевести заявку в ошибку мерчанта — после неудачной попытки получения реквизитов заявка перейдет в статус "Ошибка мерчанта"
Попробовать подключить другой мерчант — будут произведены попытки получения реквизитов от других мерчантов, подключенных в этом направлении обмена (согласно приоритету, указанного в настройках каждого модуля)
Если в настройках модуля мерчанта есть опция "Статус ошибки мерчанта":
Вы можете дополнительно настроить её (опция позволяет автоматически повторно запрашивать реквизиты у мерчанта, если они не были получены при создании заявки):
Статус ошибки — выполнится выбранное действие из опции "Действие, если мерчант не сработал" (раздел "Настройки обменника" -> "Основные настройки").
Ожидание реквизитов от мерчанта — заявка перейдет в статус "Ожидание реквизитов от мерчанта", если мерчант не сможет сразу предоставить реквизиты. Заявка перейдет обратно в статус "Новая заявка" после того, как реквизиты будут получены при повторном запросе.
Если в направлении обмена подключен только один мерчант и используется вариант "Попробовать подключить другой мерчант" с заполненным шаблоном для поля "Текст ошибки, если счёт не указан", то заявка останется в статусе "Новая заявка", вместо шорткода [to_account] будет отображен текст из поля "Текст ошибки, если счёт не указан" (если реквизиты от мерчанты должны отображаться в заявке) или будет отображаться кнопка с текстом ошибки для перехода на платежную страницу (если реквизиты для оплаты предоставляются мерчантом на собственной платежной странице)
Показать QR код на странице оплаты — отображение QR-кода при переходе к оплате на странице заявки • Нет • Да
Персональная настройка статусов, которые можно принимать — список статусов заявки, с которыми будет работать мерчант при получении уведомления об оплате от платежной системы.
Не используйте опцию "Персональная настройка статусов, которые можно принимать" без необходимости!
Если не выбран ни один из пунктов, то мерчант работает со статусами по умолчанию. Если выбрать статусы из списка, то мерчант будет работать только с выбранными статусами.
Назначить заявке статус ошибки, в случае ошибки API — при ошибке ответа со стороны мерчанта, присваивать заявке статус ошибки: • Нет • Да
Для отображения реквизитов, полученных от мерчанта, непосредственно в заявке, в поле "Инструкция по оплате для пользователя" используйте шорткод [to_account], когда мерчант подключен в направлении обмена.
Не забудьте создать задание Cron на сервере для проверки платежа —
