Готовый модуль для приёма платежей

Общее описание

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

Для начала нужно создать аккаунт в Mandarin (как зарегистрировать аккаунт?).

После регистрации у вашей компании появится Личный кабинет. В нем возможно получать информацию о статусе платежей, редактировать карточку, реквизиты компании, подключать новые проекты и сервисы, обращаться в Службу поддержки Mandarin, а также к вашему персональному менеджеру.

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

Создавать и редактировать модуль выплат может только пользователь, у которого есть на это права (выдать права может Администратор личного кабинета).

Шаг 1. Настройка

Для работы с модулем нужно зайти в раздел Модули Личного кабинета.

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

Просматривать модули можно как все созданные, так и отдельно по типу, отфильтровав их.

Чтобы создать новый модуль, нужно нажать на кнопку Добавить модуль.

Откроется страница настроек модуля, где первым делом нужно выбрать тип проекта (прием платежей или выплаты) и Merchant ID (проект), с которого будут осуществляться операции приема платежей с помощью модуля.

Настройка обязательных полей

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

Здесь вы можете настроить внешний вид страницы модуля:

• Логотип - логотип вашей компании (размер не более 2 Mb);
• Цвет фона - фон страницы модуля;
• Фоновое изображение - по желанию можете установить фоновое изображение (размер не более 2 Mb);
• Цвет кнопки - цвет кнопки оплаты;
• Цвет текста кнопки - цвет текста на кнопке оплаты.

• Название платежной страницы - здесь вы можете указать любое название для платежной страницы;
• Валюта - при необходимости укажите валюту для оплат (USD, EUR, RUB)
• Выбор цвета Названия платежной страницы - выбрать цвет этого названия;
• Формировать Номер заказа (order_id) автоматически - если у вас нет необходимости присвоить операции конкретный номер, то можно включить данную функцию;
• Скрыть поле Номер заказа из Формы Приема платежей скрыть можно только в том случае, если установлена настройка - Формировать Номер заказа (order_id) автоматически;
• Скрыть поле Email из формы Приема платежей скрыть можно только в том случае, если установлена настройка - Значение по умолчанию для поля Email.
• Значение по умолчанию для поля Email - если у вас нет информации от клиента, то указывается Email, который будет по умолчанию заполняться в форме.

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

• В настройках модуля некорректно указан email.

Настройки необязательных полей

• Скрыть поле Phone из формы выплаты - скрыть можно только в том случае, если установлена настройка - Значение по умолчанию для поля Phone;
• Значение по умолчанию для поля Phone - если у вас нет информации от клиента, то указывается номер телефона, который будет по умолчанию заполняться в форме;
• Return URL - Url для редиректа пользователя после оплаты;
• Добавить комиссию сверху суммы платежа - функция включает комиссию с плательщика, укажите в поле ниже размер комиссии, взимаемой с плательщика;

Настройка дополнительных полей и чеки

Формировать чек - если у вас подключена онлайн-касса в Mandarin через Бифит/Екам/Атол, то для модуля вы можете также, настроить чеки.

Дополнительные поля - данные поля отображаются в форме и будут присутствовать в реестрах, заполняются по желанию и их можно добавлять и удалять в любое время:

• Name - указывается название поля, например, "Номер договора".
• Value - указывается значение этого поля, например, "2022-123456" - данное значение будет заполняться в форме автоматически, его можно изменить.

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

После сохранения, в списке появится ваш модуль, который можно в любой момент отредактировать с помощью кнопки Действия → Изменить настройки.

Шаг 2. Использование

Оплата по ссылке модуля

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

На странице самого модуля будут представлены ранее настроенные поля:

• Ваш логотип;
• Название платежной страницы;
• Email - если он не был установлен по умолчанию и не был скрыт;
• Сумма платежа;
• Дополнительные поля - если они были настроены для модуля.

После заполнения полей откроется форма оплаты, где клиент должен ввести данные своей карты и нажать "Оплатить".

Если все данные внесены корректно, то появится окно об успешной оплате.

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

Создание счета на оплату

Создать счет на оплату можно через кнопку Действия.

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

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

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

Сопровождение и ошибки

Если какие-то данные были введены некорректно, то поле будет подсвечено красным. В таком случае нужно проверить корректность введенных данных и повторить ввод. Затем еще раз перейти к оплате.

В истории операций вы можете:

• Отслеживать статус оплат.
• Просматривать описание ошибки, в случае её возникновения, в расширенной информации. Также, описание ошибок есть у нас в статье Коды ошибок Visa/MasterCard/МИР.
• Совершать поиск операций по номеру заказа или номеру карты.
• Просматривать с какого проекта совершена была операция.

• Обновить статус транзакции, если она находится в статусе processing длительное время.

Если вы столкнулись с ошибкой в Личном кабинете, рекомендуем собрать лог браузера (HAR-лог), сделать скриншоты полноэкранные, где возникает ошибка или видео экрана и направить в службу поддержки для подробного анализа ситуации.