Контроль и проведение платежей

Общая информация

Dashboard позволяет проводить оплаты по платёжным ссылкам. Это тип платежа, в рамках которого на основании одного исходного запроса осуществляются создание и отправка платёжной ссылки пользователю, а затем разовый перевод денежных средств от пользователя к мерчанту (в удобное пользователю время).

Общая схема проведения оплат по платёжным ссылкам представлена в разделе Оплата по платёжной ссылке. При работе с интерфейсом Dashboard можно создавать и отправлять платёжные ссылки, управлять этими ссылками и контролировать проведение платежей по ним. Также для работы с такими платежами в платёжной платформе ECommPay может использоваться интерфейс Gate.

Подключение оплат по платёжным ссылкам осуществляется по проектам: для всех методов, используемых в рамках выбранного проекта и поддерживающих такую возможность. Для уточнения методов, для которых доступны оплаты по ссылкам, и порядка подключения этой возможности следует обращаться к курирующему менеджеру ECommPay.

Условия

Для работы с платёжными ссылками в интерфейсе Dashboard должны соблюдаться следующие условия:

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

Вопросы, касающиеся распределения прав, можно решать на месте — со специалистами мерчанта.

Оплаты по ссылкам

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

1. Открыть вкладку формирования ссылки.

   Для этого необходимо открыть раздел Ссылки на оплату и щёлкнуть кнопку Новая ссылка на оплату слева на панели фильтрации.

2. Задать параметры оплаты и сформировать ссылку.

   Для этого необходимо заполнить поля и щёлкнуть кнопку Создать ссылку на оплату.

   При заполнении полей стоит учитывать ряд особенностей:

   • сумма указывается с отделением дробной части с помощью точки (например, 314.15);
   • выбор платёжного метода становится доступным после указания идентификатора платежа и проекта;
   • если включён переключатель Отправить на email, то платёжная ссылка автоматически отправляется на адрес электронной почты пользователя веб-сервиса, а если выключен — то её следует отправить пользователю самостоятельно;
   • в случае некорректного заполнения полей отображаются уведомления об ошибках;
   • кнопка Создать ссылку на оплату становится активной, когда корректно указаны обязательные параметры (к обязательным не относятся описание платежа и адрес электронной почты, но их желательно заполнять для минимизации рисков при проведении платежа).

   

3. При необходимости отправить пользователю платёжную ссылку.

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

4. Убедиться, что оплата проведена.

   Для этого можно проверить статус оплаты в реестре платежей или оплат по платёжным ссылкам — он должен принять значение success. Полный список возможных статусов такого типа платежа и пояснений к ним представлен в модели проведения оплаты по платёжной ссылке.

Если требуется деактивировать платёжную ссылку (до того, как пользователь произвёл оплату), следует включить переключатель Деактивация ссылки в соответствующей строке реестра в разделе Ссылки на оплату. После этого ссылка становится недействительной и не может применяться для проведения оплаты, даже если она была отправлена пользователю.

Условия

Dashboard позволяет выполнять возвраты на полную и частичную сумму оплаты. При этом может использоваться единичная и пакетная отправка запросов и в любом случае должны соблюдаться следующие условия:

• доступ к интерфейсу Dashboard для используемой учётной записи должен осуществляться с применением двухфакторной аутентификации;
• у используемой учётной записи должно быть право на выполнение возвратов;
• оплата, по которой требуется выполнить возврат, должна быть проведена;
• для платёжного метода, с использованием которого была проведена оплата, должны поддерживаться возвраты требуемого типа;
• на балансе, по которому была проведена оплата, должно быть достаточно средств для выполнения возврата.

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

Одиночные возвраты

Чтобы выполнить одиночный возврат, следует:

1. При необходимости, найти целевую оплату — ту, по которой необходимо выполнить возврат.

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

2. Открыть карточку целевой оплаты.

   Для этого следует щёлкнуть соответствующую строку в реестре раздела Платежи.

3. Отправить запрос на возврат.

   Для этого следует:

   1. Щёлкнуть кнопку Возврат, расположенную на панели информации о платеже.

      

   2. Указать в открывшемся окне требуемую сумму возврата (полную доступную или её часть).
   3. Подтвердить выполнение возврата, щёлкнув кнопку Возврат.
   Прим.: Если кнопка Возврат не активна, это может свидетельствовать о том, что оплата ещё не проведена, а если отсутствует — о том, что для используемого платёжного метода не поддерживается выполнение возвратов через отправку запросов.
4. Убедиться, что возврат выполнен.

   Для этого можно проверить статус операции в карточке платежа (он должен принять значение success) или статус платежа в реестре (при возврате полной суммы он должен принять значение refunded или reversed, а при возврате частичной суммы — partially refunded).

Если возврат был отклонён, то статус операции принимает значение decline, а статус платежа не меняется. Это может быть вызвано разными причинами. И, например, в случае отказа из-за того, что на балансе оказалось недостаточно средств, можно пополнить баланс и повторить попытку возврата.

Массовые возвраты

Чтобы выполнить группу возвратов с отправкой запросов одним пакетом (массовый возврат), следует:

1. Подготовить файл заданного формата с информацией о целевых возвратах.

   Требования к таким файлам представлены далее, вместе с шаблоном и примером заполнения.

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

   Для этого следует открыть раздел Выплаты, щёлкнуть кнопку Запрос слева на панели фильтрации и перейти на вкладку массовых возвратов.

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

   Для загрузки можно перетащить файл в область загрузки или использовать кнопку Выберите файл.

   Для проверки корректности стоит убедиться в том, что либо стала активной кнопка Отправить запрос, либо отобразилось уведомление об ошибках. Во втором случае можно изучить информацию об ошибках (используя переключатель Предварительный просмотр и далее кнопку Информация о файле), скорректировать файл и загрузить его повторно.

   
4. Отправить пакет запросов на выполнение.

   Для этого следует щёлкнуть кнопку Отправить запрос.

5. Убедиться в выполнении запросов.

   При отправке запросов в интерфейсе отображается сообщение об их приёме, после чего можно убедиться в проведении возвратов, проверив статус пакета в реестре массовых запросов — он должен принять значение Done (для этого следует щёлкнуть кнопку Массовые запросы на панели фильтрации в разделе Выплаты и найти в реестре строку требуемого пакета). В этом реестре дополнительно можно ориентироваться на статусы отдельных возвратов с помощью элементов Indicator. Стоит учитывать, что время, необходимое для выполнения возвратов и отображения информации об их статусах, может существенно варьироваться в зависимости от количества запросов в пакете.

   Для проверки статусов отдельных возвратов можно проверять статусы целевых оплат в реестре платежей (они должны принимать значения refunded или reversed при возврате полной суммы и partially refunded при возврате частичной суммы), а также проверять статусы возвратов в карточках целевых оплат (эти статусы должны принимать значение success или decline в зависимости от результата операции).

   

С любыми вопросами о выполнении возвратов можно обращаться к специалистам технической поддержки ECommPay.

Условия

Dashboard позволяет проводить выплаты с использованием единичной и пакетной отправки запросов, и в любом из этих случаев должны соблюдаться следующие условия:

• доступ к интерфейсу Dashboard для используемой учётной записи должен осуществляться с применением двухфакторной аутентификации;
• у используемой учётной записи должно быть право на проведение выплат;
• для выбранного платёжного метода должно поддерживаться проведение выплат;
• на балансе, с использованием которого необходимо провести выплаты, должно быть достаточно средств;
• если для проведения выплаты требуются дополнительные данные, они могут быть предоставлены не более чем в течение 22 часов.

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

При любом из вариантов проведения выплат — с единичной или пакетной отправкой запросов — доступна возможность повторных попыток в тех случаях, когда первоначальная попытка отклонена по таким причинам, как, например, достижение суточного лимита на сумму выплат, заданного на стороне платёжной системы, или недоступность сервисов платёжной системы. Повторные попытки могут выполняться платёжной платформой автоматически, через заданный период, или специалистами технической поддержки вручную, и количество таких попыток ограничено. Подключить возможность выполнения повторных попыток можно по согласованию с курирующим менеджером ECommPay, а для настройки количества попыток и периода между их выполнением следует обращаться к специалистам технической поддержки (support@ecommpay.com).

Одиночные выплаты

Чтобы провести одиночную выплату, следует:

1. Перейти на вкладку Одиночная выплата.

   Для этого необходимо открыть раздел Выплаты, щёлкнуть кнопку Запрос слева на панели фильтрации.

2. Задать параметры выплаты и отправить запрос.

   Для этого необходимо заполнить поля и щёлкнуть кнопку Отправить запрос.

   При заполнении полей стоит учитывать ряд особенностей:

   • сумма указывается с отделением дробной части с помощью точки (например, 314.15);
   • поля для специфических параметров разных платёжных методов отображаются после указания проекта, суммы, валюты и платёжного метода;
   • в числе специфических полей отображаются только обязательные для заполнения;
   • в случае некорректного заполнения полей отображаются уведомления об ошибках;
   • кнопка Отправить запрос становится активной, когда корректно указаны все параметры.

   

3. Если требуется дополнить информацию о платеже — указать дополнительные параметры (также можно отклонить платёж).

   При проведении выплаты выполняются проверки её параметров, при этом в интерфейсе, на вкладке Одиночная выплата, отображается соответствующее сообщение. Если по итогам таких проверок параметры удовлетворяют предъявляемым условиям, то в интерфейсе отображается сообщение об успешной обработке запроса; если же выявляется, что отсутствуют какие-либо параметры, которые не обязательны в общем случае, но необходимы в конкретной ситуации, в интерфейсе отображаются поля для указания этих параметров. В таком случае можно продолжить платёж, указав необходимые данные и щёлкнув кнопку Продолжить, либо отклонить проведение платежа, щёлкнув кнопку Reject Payout.

   Если по каким-либо причинам (например, для уточнения информации) требуется прервать работу и вернуться к выплате позже, найти эту выплату можно в реестре выплат, отфильтровав записи с помощью фильтра Clarification и щёлкнув соответствующую строку.

   Ограничение: По умолчанию время для дополнения информации составляет 22 часа с момента выявления необходимости дополнить данные, но для некоторых платёжных систем это время может быть меньшим. За уточнениями о работе с конкретными методами можно к сотрудникам технической поддержки ECommPay.

   

4. Убедиться, что выплата проведена.

   Для этого можно проверить статус этой выплаты в реестре выплат или платежей — он должен принять значение success.

Если выплата была отклонена, её статус принимает значение decline. Это может быть вызвано разными причинами. И, например, в случае отказа из-за того, что на балансе оказалось недостаточно средств, можно пополнить баланс и повторить попытку выплаты.

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

Основная процедура

Чтобы провести группу выплат с отправкой запросов одним пакетом (массовую выплату), следует:

1. Подготовить файл заданного формата с информацией о целевых выплатах.

   Требования к таким файлам представлены далее, вместе с шаблоном и примером заполнения.

2. Перейти на вкладку Массовые выплаты.

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

3. Загрузить подготовленный файл со списком выплат и отправить пакет запросов на выполнение.

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

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

   

4. Убедиться в достаточности данных и проведении выплат.

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

   Если в результате обработки запросов хотя бы для одной из выплат пакета требуется дополнительная информация, то статус пакета принимает значение Clarification. В такой ситуации можно указать для отдельных выплат дополнительные параметры либо отклонить их проведение. Информация об этих действиях описана далее.

   Также при работе с реестром массовых запросов дополнительно можно ориентироваться на статусы отдельных выплат с помощью элементов Indicator.

   

Дополнение информации

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

Если для каких-либо выплат в пакете ожидается дополнение информации, можно выборочно указать дополнительные параметры или отклонить выплаты. При этом в таких случаях можно работать с отдельными выплатами (что может быть удобным, например, когда требуется предоставить данные только об одной из выплат пакета) или одновременно с несколькими (например, если необходимо дополнить информацию сразу по нескольким выплатам) — дополняя информацию непосредственно в интерфейсе Dashboard или в файле.

Для дополнения информации об отдельной выплате следует:

1. Найти и открыть карточку целевой выплаты.

   Для этого можно отфильтровать записи в реестре Все запросы с помощью фильтра Clarification и щёлкнуть нужную строку.

2. Указать запрашиваемые данные и продолжить платёж, щёлкнув кнопку Продолжить.

Также через карточку выплаты можно отклонить её проведение, используя кнопку Reject Payout.

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

1. Найти и открыть пакет, к которому относятся целевые выплаты — те, значения параметров которых необходимо указать.

   Для этого можно отфильтровать записи в реестре Массовые запросы с помощью фильтра Clarification и щёлкнуть нужную строку.

2. Активировать режим редактирования данных, щёлкнув кнопку Manage слева на панели фильтрации.
3. Указать требуемые параметры.

   Это можно сделать непосредственно через интерфейс Dashboard, введя данные в ячейки со значком , либо через обновление файла. Во втором случае необходимо выгрузить файл, используя кнопку , указать в этом файле требуемые параметры в ячейках со значением *required* и загрузить дополненный файл, используя кнопку .

   В каждом из этих случаев можно дополнять данные не по всем выплатам, а только по необходимым. Остальные в таком случае будут отклонены по истечении времени ожидания данных.

   Ограничение: По умолчанию время для дополнения информации составляет 22 часа с момента выявления необходимости дополнить данные, но для некоторых платёжных систем это время может быть меньшим. За уточнениями о работе с конкретными методами можно к сотрудникам технической поддержки ECommPay.

   

4. Сохранить изменения и отправить данные, щёлкнув кнопку Продолжить.

Также в режиме редактирования можно отклонить проведение отдельных выплат, установив флажки в соответствующих строках (в первом столбце таблицы) и щёлкнув кнопку Отклонить.

С любыми вопросами о проведении выплат можно обращаться к специалистам технической поддержки ECommPay.

Требования к файлам

Для подготовки файла можно использовать шаблон, доступный для скачивания в интерфейсе Dashboard на вкладке массового добавления или по ссылке. После загрузки шаблона его можно заполнить в любом редакторе файлов формата CSV, например, MS Excel. При этом каждый файл, используемый для массового добавления критериев должен удовлетворять следующим требованиям:

Используемые параметры

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

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

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