Массовые платежи

Обзор подраздела

Данный подраздел предназначен для проведения платежей — единичных и массовых выплат, массовых возвратов средств пользователям, массового подтверждения оплаты с блокировкой средств или отмены блокировки средств — а также для отслеживания истории отправленных через Old Dashboard запросов на проведение платежей.

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

Рис.: Информация о запросах



В таблице представлена информация об отправленных запросах: идентификаторы платежа и пакета операций (для единичных выплат указывается идентификатор платежа, для массовых платежей — идентификатор пакета), общее количество операций в файле, а также в скобках количество операций завершенных со статусом success или decline со знаками плюс и минус соответственно, статус обработки запроса, дата и время его отправки, название файла, используемого для массового выполнения операций, и название проекта, в рамках которого они осуществлены.

Статус обработки запроса отображается в столбце Статус и может принимать одно из следующих значений:
  • processing — запрос ожидает отправки,
  • done — запрос сформирован и отправлен на обработку.
Информация в данном разделе отображается только по тем проектам, к которым есть доступ у используемой учетной записи Old Dashboard. Для создания запросов в данном подразделе необходимо:
  • обладать правом проведения платежей,
  • указать номер телефона для получения кодов подтверждения (подробнее см. в разделе Профиль пользователя),
  • использовать двухфакторную аутентификацию для входа в Old Dashboard (подробнее см. в разделе Безопасность).

Данные в разделе отображаются спустя примерно 2 минуты после совершения платежа.

Единичная выплата

Для создания и отправки запроса на единичную выплату необходимо:
  1. Перейти на вкладку Единичная выплата в правой части окна.
  2. Выбрать проект, в рамках которого необходимо провести выплату.
  3. Указать сумму и выбрать валюту из списка, при этом сумму можно указать в целых единицах или с отделением дробной части точкой, например, 100 или 55.50.
  4. Выбрать платёжный метод, доступный для проведения выплаты в рамках данного проекта, например, card.
  5. Заполнить все поля в форме подготовки и отправки запроса таким образом, чтобы их значения удовлетворяли требованиям спецификации API в соответствии с выбранным платежным методом. Описание наиболее часто используемых параметров представлено далее.

    При переходе Назад ввод данных сбрасывается.

  6. Щелкнуть кнопку Запрос на выплату.
  7. Убедиться в отправке запроса, получив окно с уведомлением.

Рис.: Форма отправки запроса на выполнение единичной выплаты на примере карт



После отправки запроса отследить статус его обработки можно в таблице подраздела, а статус платежа — в разделе Платежи.

При проведении единичных выплат через 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Б;
  • первая строка должна содержать названия параметров, при этом названия могут указываться в любой последовательности;
  • последующие строки должны содержать значения целевых параметров, при этом для необязательных параметров значения могут не указываться;
  • все указываемые значения параметров в файле должны удовлетворять требованиям, представленным далее в таблице;
  • в случае, если названия и значения параметров операций задаются текстовыми строками (не в формате таблицы), в качестве разделителя значений параметров используется «;» (точка с запятой), при этом поля без значений разделяются точкой с запятой так же, как и поля со значениями и допускаются ситуации с идущими подряд двумя и более знаками «;», например:


Порядок проведения массового платежа

Для отправки запроса на проведение массового платежа необходимо:
  1. Перейти на вкладку Массовые платежи в правой части окна.
  2. Загрузить подготовленный файл со списком операций в формате CSV.
  3. Щёлкнуть кнопку OK.
  4. Убедиться в отправке запроса, получив окно с уведомлением.

Рис.: Форма отправки запроса на выполнение массового платежа



Далее можно отследить статус обработки запроса в таблице подраздела, а статусы операций — в разделе Операции.

При проведении массовых выплат через 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

Возможные ошибки

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

Табл. 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) Указанный месяц действия карты истёк