Массовые выплаты по реестру
Массовые выплаты по реестру позволяют отправлять выплаты получателям без программирования и интеграции с API Mandarin — через готовую форму в личном кабинете. Для этого используется реестр с данными получателей и суммами выплат. Для такого сценария нужны полные номера карт получателей.
Шаг 1. Регистрация и подготовка
Чтобы использовать массовые выплаты по реестру, нужно:
- зарегистрировать личный кабинет в Mandarin
- предоставить документы и пройти согласование у банка-партнера
- открыть расчетный счет для выплат в банке, где пройдено согласование
- пополнить счет для массовых выплат.
Шаг 2. Добавление проекта для выплат
Если проект для выплат еще не создан, сначала нужно добавить его. После этого в настройках проекта откройте раздел «Форма для выплат» и активируйте выплаты.
Шаг 3. Подготовка реестра
Перед запуском массовых выплат рекомендуется сначала провести тестовые операции.
Для реестра нужно заполнить несколько полей:
- order_id — номер заказа
- amount — сумма выплаты, разделитель десятичной части — точка, например
100.55 - card_number — полный номер карты получателя
- email — почта получателя, если она не задана по умолчанию в форме для выплат
- phone — телефон получателя, если он не задан по умолчанию в форме для выплат
Если Email и Phone уже заполнены по умолчанию в настройках формы, в реестр их добавлять не нужно.
Если в форме настроены дополнительные поля, они тоже появятся в шаблоне реестра, и их нужно будет заполнить. Важно проверить, чтобы названия столбцов для допо лнительных полей присутствовали в файле.
Форматирование файла и выравнивание ячеек не влияют на обработку реестра.
Шаг 4. Скачать шаблон реестра
Чтобы скачать пустой шаблон, откройте раздел «Выплаты», перейдите на вкладку «Реестры», выберите проект и нажмите «Скачать шаблон реестра».
Шаг 5. Загрузка реестра
После заполнения шаблона загрузите его в систему.
Перед запуском выплат важно еще раз проверить все данные, особенно номера карт, чтобы исключить ошибочные переводы.
Шаг 6. Запуск выплат
После загрузки система покажет количество транзакций и общую сумму по реестру. Если данные совпадают, можно нажать «Начать выплаты».
Если данные в файле корректны, выплаты будут отправлены, а затем откроется страница с реестрами, где можно посмотреть их статус и при необходимости скачать отчет по операциям.
История операций
Все транзакции по массовым выплатам отображаются и в разделе «История операций». Там можно посмотреть:
- статус операции
- ошибки
- пользователя, который инициировал выплаты.
Статусы реестров
Для реестров доступны три основных статуса.
Загружен
Реестр успешно загружен, но выплаты по нему еще не отправлены. Если нажать на статус, можно запустить выплаты.
Обработан
Реестр успешно загружен, и выплаты по нему созданы. Этот статус не означает, что все операции прошли без ошибок. Чтобы проверить результат, нужно скачать отчет и убедиться, что внутри нет проблем по отдельным транзакциям. Например, в отчете может быть указано, что карта заблокирована или номер карты введен неверно.
Обработан с ошибками
Реестр загружен, но не отправлен. Причины можно посмотреть в отчете.
Как скачать отчет
Чтобы скачать отчет по реестру, откройте нужный реестр и выберите действие «Скачать отчет».
Возможные ошибки
Ошибка валидации после нажатия «Начать выплаты»
Обычно это означает, что в файле есть ошибка: лишний символ, пробел или некорректный формат данных. Нужно проверить реестр, исправить файл и загрузить его заново.
Invalid card number
Неверно указан номер карты. Нужно проверить номер карты в реестре.
Email is missing
Поле с email отсутствует в реестре. Такая ошибка возникает, если email не задан по умолчанию в настройках формы и при этом не указан в файле. Нужно либо добавить email в реестр, либо задать его по умолчанию в настройках модуля.
Invalid phone format
Поле с номером телефона отсутствует или заполнено некорректно. Такая ошибка возникает, если телефон не задан по умолчанию в настройках формы и при этом не указан в реестре. Нужно либо добавить телефон в файл, либо указать значение по умолчанию в настройках формы.