Массовые платежи
Обзор подраздела
Данный подраздел предназначен для проведения платежей — единичных и массовых выплат, массовых возвратов средств пользователям, массового подтверждения оплаты с блокировкой средств или отмены блокировки средств — а также для отслеживания истории отправленных через Old Dashboard запросов на проведение платежей.
В данном подразделе отображаются таблица с информацией о запросах, блок фильтрации таблицы и навигации по её страницам, а также вкладки для создания и отправки запросов.
Рис.: Информация о запросах
В таблице представлена информация об отправленных запросах: идентификаторы платежа и пакета операций (для единичных выплат указывается идентификатор платежа, для массовых платежей — идентификатор пакета), общее количество операций в файле, а также в скобках количество операций завершенных со статусом success или decline со знаками плюс и минус соответственно, статус обработки запроса, дата и время его отправки, название файла, используемого для массового выполнения операций, и название проекта, в рамках которого они осуществлены.
- processing — запрос ожидает отправки,
- done — запрос сформирован и отправлен на обработку.
- обладать правом проведения платежей,
- указать номер телефона для получения кодов подтверждения (подробнее см. в разделе Профиль пользователя),
- использовать двухфакторную аутентификацию для входа в Old Dashboard (подробнее см. в разделе Безопасность).
Данные в разделе отображаются спустя примерно 2 минуты после совершения платежа.
Единичная выплата
- Перейти на вкладку Единичная выплата в правой части окна.
- Выбрать проект, в рамках которого необходимо провести выплату.
- Указать сумму и выбрать валюту из списка, при этом сумму можно указать в целых единицах или с отделением дробной части точкой, например, 100 или 55.50.
- Выбрать платёжный метод, доступный для проведения выплаты в рамках данного проекта, например, card.
- Заполнить все поля в форме подготовки и отправки запроса таким образом, чтобы их значения удовлетворяли требованиям спецификации API в соответствии с выбранным платежным методом. Описание наиболее часто используемых параметров представлено далее.
При переходе Назад ввод данных сбрасывается.
- Щелкнуть кнопку Запрос на выплату.
- Убедиться в отправке запроса, получив окно с уведомлением.
Рис.: Форма отправки запроса на выполнение единичной выплаты на примере карт
После отправки запроса отследить статус его обработки можно в таблице подраздела, а статус платежа — в разделе Платежи.
При проведении единичных выплат через Old Dashboard доступна возможность повторных попыток в тех случаях, когда первоначальная попытка отклонена по таким причинам, как, например, достижение суточного лимита на сумму выплат, заданного на стороне платёжной системы, или недоступность сервисов платёжной системы. Повторные попытки могут выполняться платёжной платформой автоматически, через заданный период, или специалистами технической поддержки вручную, и количество таких попыток ограничено. Подключить возможность выполнения повторных попыток можно по согласованию с курирующим менеджером ECommPay, а для настройки количества попыток и периода между их выполнением следует обращаться к специалистам технической поддержки (support@ecommpay.com).
Массовый платеж
Общая информация
Массовый платёж представляет собой пакет операций, параметры которых задаются со стороны мерчанта в файле формата CSV заданной структуры.
- capture — подтверждение списания заблокированных средств на карте пользователя,
- cancel — отмена блокировки средств на карте пользователя.
- refund— возврат средств пользователю,
- payout — выплата средств пользователю с указанием реквизитов платежного инструмента,
- payout/token — выплата средств пользователю с указанием токена карты.
Для подготовки файла можно использовать Шаблон массовых платежей, доступный для скачивания в нижней части вкладки или по ссылке. После загрузки шаблона его можно заполнить в любом редакторе файлов формата CSV, например, MS Excel.
Рис.: Пример заполненного файла
Пример заполненного файла для выплат на карты пользователей досупен по ссылке.
Пример заполненного файла для выплат пользователям с помощью альтернативных платежных методов досупен по ссылке.
После загрузки через Old Dashboard готового файла в платежной платформе ECommPay проверяется корректность его данных и выполняются все указанные операции.
Требования к используемым файлам
- должен использоваться формат CSV с кодировкой символов UTF-8 без использования маркеров очерёдности (Byte Order Mark, BOM);
- размер файла не должен превышать 128 MБ;
- первая строка должна содержать названия параметров, при этом названия могут указываться в любой последовательности;
- последующие строки должны содержать значения целевых параметров, при этом для необязательных параметров значения могут не указываться;
- все указываемые значения параметров в файле должны удовлетворять требованиям, представленным далее в таблице;
- в случае, если названия и значения параметров операций задаются текстовыми строками (не в формате таблицы), в качестве разделителя значений параметров используется «;» (точка с запятой), при этом поля без значений разделяются точкой с запятой так же, как и поля со значениями и допускаются ситуации с идущими подряд двумя и более знаками «;», например:
Порядок проведения массового платежа
- Перейти на вкладку Массовые платежи в правой части окна.
- Загрузить подготовленный файл со списком операций в формате CSV.
- Щёлкнуть кнопку OK.
- Убедиться в отправке запроса, получив окно с уведомлением.
Рис.: Форма отправки запроса на выполнение массового платежа
Далее можно отследить статус обработки запроса в таблице подраздела, а статусы операций — в разделе Операции.
При проведении массовых выплат через Old Dashboard доступна возможность повторных попыток в тех случаях, когда первоначальная попытка отклонена по таким причинам, как, например, достижение суточного лимита на сумму выплат, заданного на стороне платёжной системы, или недоступность сервисов платёжной системы. Повторные попытки могут выполняться платёжной платформой автоматически, через заданный период, или специалистами технической поддержки вручную, и количество таких попыток ограничено. Подключить возможность выполнения повторных попыток можно по согласованию с курирующим менеджером ECommPay, а для настройки количества попыток и периода между их выполнением следует обращаться к специалистам технической поддержки (support@ecommpay.com).
Параметры массовых платежей
При заполнении данных в файлах могут использоваться параметры, представленные в таблице. Более полная информация об этих параметрах содержится в спецификации API.
| Параметр | Обязательность | Тип | Описание | Пример |
|---|---|---|---|---|
| operation_type | да | string | Тип операции. Доступные значения: capture, cancel, refund, payout, payout/token | payout |
| general.project_id | да | integer | Идентификатор проекта, полученный от ECommPay | 35 |
| method | да | string | Код платежного метода, через который будет проходить платеж, список доступен в разделе Коды платежных методов, поддерживаемых в Old Dashboard | card |
| general.payment_id | да | string (minLength: 1; maxLength: 255) | Уникальный идентификатор платежа в проекте (набор любых букв, цифр или символов в кодировке UTF-8) | 123ID |
| payment.amount | да | integer (minimum: 1 maximum: 10000000000000) | Сумма платежа в минорных единицах валюты (без разделителя между целой и дробной частями) | 1000 |
| payment.currency | да | string | Код валюта платежа в формате ISO 4217 alpha-3 | EUR |
| payment.description | да для refund | string (maxLength:255) | Описание платежа | refund123 |
| account.number | нет | string (maxLength:100 minLength:1) | Номер счета покупателя | 1670033323 |
| account.bank_id | нет | integer (minimum:1) | Идентификатор банка в платёжной платформе ECommPay. Список может быть получен из технической документации или от специалистов технической поддержки | 123 |
| account.customer_name | нет | string (minLength:1) | Полное имя держателя счета | John Johnson |
| account.branch | нет | string (maxLength:255) | Наименование филиала банка, где открыт счет покупателя | Branch |
| account.city | нет | string (minimum:1 maxLength:255) | Город расположения филиала банка | London |
| account.region_id | нет | integer (minimum:1) | Идентификатор региона или штата расположения филиала банка, полученный от ECommPay | 123 |
| card.pan | да для payout и если не указан card.token | integer (maxLength:32) | Номер карты пользователя | 4242424242424242 |
| card.year | да, для payout | integer (minimum:2019 maximum:9999) | Год истечения срока действия карты пользователя | 2020 |
| card.month | да для payout | integer (minimum:1 maximum:12) | Месяц истечения срока действия карты пользователя | 12 |
| card.card_holder | да для payout | string (maxLength:255) | Имя держателя карты | John Johnson |
| token | да для payout и если не указан card.pan | string | Токен платежного инструмента, полученный от ECommPay | Z0yTL5shY8ddhpxdQyplRPJYmGV7Kv |
| customer.id | да для payout | string (maxLength:255) | Идентификатор пользователя в проекте | 312ID |
| customer.country | да для payout | string | Код страны проживания пользователя в формате ISO 3166-1 alpha-2 | GB |
| customer.city | да для payout | string (maxLength:255) | Город проживания пользователя | London |
| customer.state | нет | string (maxLength:255) | Область или штат расчетного адреса пользователя | West Midlands |
| customer.zip | нет | string (maxLength:16) | Почтовый индекс адреса пользователя | B152SA |
| customer.street | нет | string | Улица расчетного адреса пользователя | Edgbaston |
| customer.first_name | да для payout | string (maxLength:255) | Имя пользователя | John |
| customer.last_name | да для payout | string (maxLength:255) | Фамилия пользователя | Johnson |
| customer.day_of_birth | да для payout | string | Дата рождения пользователя в формате ДД-ММ-ГГГГ | 21-12-1989 |
| customer.phone | нет | string | Номер телефона пользователя, от 4 до 24 цифр | 79105216611 |
| customer.email | нет | string (maxLength:255) | Электронная почта пользователя | test@mail.com |
| customer.ip_address | да для payout | string (maxLength:255) | IP-адрес пользователя | 127.0.0.1 |
Возможные ошибки
После проверки корректности отправляемых данных в интерфейсе отображается сообщение об успешной обработке запроса или сообщение об ошибках, возникших в процессе обработки. Также список возникших ошибок возможно получить, щелкнув на количество операций в столбце Количество таблицы со списком загруженных файлов. Возможные ошибки описаны далее.
| Сообщение об ошибке в Dashboard | Причина |
|---|---|
| Incorrect file format | Некорректное расширение или формат файла |
| Broken file | Некорректная кодировка или структура данных |
| Payment method is not available (line# number) | Платежный метод недоступен |
| Specified project_id does not belong to specified merchant account | Проект не принадлежит данному мерчанту |
| Project_id is not numeric (line# number) | Указан нечисловой идентификатор проекта |
| Project_id does not exist (line# number) | Указан несуществующий идентификатор проекта |
| Payment_id is empty (line# number) | Не указан идентификатор платежа |
| Payment with payment_id already exists (line# number) | Указан уже зарегистрированный идентификатор платежа |
| Amount is empty (line# number) | Не указана суммы платежа |
| Incorrect Amount (line# number) | Сумма платежа указана некорректно |
| Currency is empty (line# number) | Не указана валюта платежа |
| Incorrect Currency (line# number) | Валюта платежа указана некорректно |
| Invalid date | Срок действия карты не указан или указан некорректно |
| Card.year is in past (line# number) | Указанный год действия карты истёк |
| Card.month is in past (line# number) | Указанный месяц действия карты истёк |