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

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

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

  • Платежи — для контроля проведения платежей всех типов и выполнения отдельных операций, включая подтверждения и отмены списаний по двухстадийным оплатам, возвраты по оплатам любых типов и выплаты;
  • Ссылки на оплату — для работы с платёжными ссылками;
  • Мануальные платежи — для работы с одиночными оплатами MO/TO и выплатами, а также с групповыми подтверждениями и отменами списаний по двухстадийным оплатам и групповыми возвратами и выплатами;
  • Подписки — для работы с регулярными оплатами.

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

Рис.: Реестр платежей в разделе «Платежи»



Для выполнения операций по платежам в интерфейсе Dashboard поддерживаются два подхода:

  • одиночный — с указанием параметров непосредственно в интерфейсе Dashboard и с отправкой и выполнением одного запроса на одну операцию;
  • массовый — с указанием параметров через загрузку файла заданного формата и с отправкой и выполнением пакета запросов (из файла) на произвольное количество операций.

Доступ к разделам Платежи и Мануальные платежи и к отдельным возможностям по работе с ними регулируется соответствующими правами. Поэтому в случаях, когда какая-либо из описанных возможностей оказывается недоступной, следует проверять наличие требуемых прав у используемой учётной записи. Кроме того, для проведения оплат MO/TO и выплат требуется использование двухфакторной аутентификации при доступе к интерфейсу Dashboard и может использоваться подтверждение выплат с использованием кода из SMS-сообщения. Подробнее о двухфакторной аутентификации и подтверждении финансовых операций описано в разделе Порядок доступа.

Далее описан порядок действий, необходимых для контроля и проведения платежей, а также приведены основные сведения о работе с пакетами операций.

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

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

Рис.: Карточка платежа в разделе Платежи

Фактически, для контроля информации об интересующих платежах достаточно следующих действий:

  1. Перейти в нужный раздел: Платежи, Ссылки на оплату, Мануальные платежи или Подписки.
  2. Найти в реестре записи о требуемых платежах, используя инструменты фильтрации, если это необходимо.
  3. Проверить интересующую информацию, непосредственно в реестре или в карточках платежей, если они доступны.

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

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

    Так, если по оплате в 100 EUR был выполнен частичный возврат в 20 EUR, то статус partially refunded будет относиться к сумме в 100 EUR, а сумма возврата и оставшиеся средства будут отображаться в полях Возвращено и Доступно для возврата.

    Другой пример — регулярная оплата с серией списаний в одном платеже. Для такой оплаты в поле Сумма отображается актуальная сумма всех поступивших средств.

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

Проведение оплат

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

В интерфейсе Dashboard поддерживаются возможности:

  • Работать с платёжными ссылками — формировать, отправлять и деактивировать их. Схема проведения оплат по платёжным ссылкам представлена в отдельном разделе.
  • Проводить оплаты MO/TO (Mail Order / Telephone Order) — с использованием виртуальной платёжной формы и указанием реквизитов, предоставленных пользователями через электронную почту, телефон или иные средства связи. Детали проведения оплат MO/TO представлены в отдельном разделе.
  • Управлять списаниями по оплатам в две стадии — подтверждать списание заблокированных средств и отменять блокировку средств с использованием единичной и пакетной отправки запросов. Схема проведения оплат в две стадии представлена в отдельном разделе.

Условия

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Оплаты MO/TO

Чтобы провести оплату MO/TO, следует:

  1. Перейти на вкладку MO/TO (vPOS терминал).

    Для этого следует открыть раздел Мануальные платежи, щёлкнуть кнопку Запрос в левой части на панели фильтрации и перейти на вкладку MO/TO (vPOS терминал).

  2. Задать параметры оплаты и отправить запрос на открытие платёжной формы.

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

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

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

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

    (В поле Страна необходимо указывать код страны в соответствии со стандартом ISO 3166-1 alpha-2; список таких кодов приведён в разделе Коды стран).

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

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

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

Одиночные подтверждения и отмены списаний

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

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

    Для этого можно воспользоваться поиском (например, по идентификатору платежа) или перейти в раздел Платежи и использовать реестр и фильтры (например, по типу операции — auth или ее статусу — awaiting capture).

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

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

  3. Отправить запрос на подтверждение (отмену) списания заблокированных средств.

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

    1. Щёлкнуть кнопку Списание, чтобы списать заблокированные средства (Отмена, чтобы отменить блокировку средств), в правой верхней части панели информации о платеже.
    2. Указать в открывшемся окне требуемую сумму, которая может составлять полную или частичную сумму заблокированных средств.

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

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

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

Если запрос на выполнение операции был отклонён, то статус такой операции принимает значение decline, а статус платежа не меняется — остаётся awaiting capture.

Массовые подтверждения и отмены списаний

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

  1. Подготовить файл заданного формата с информацией о подтверждениях (отменах) списаний по целевым оплатам.
    Требования к таким файлам представлены далее.
    Ограничение: При подготовке файла необходимо учесть, что в нём должны содержаться операции только одно типа — capture или cancel, а сумму подтверждения (отмены) может составлять как полная, так и частичная сумма заблокированных средств. При изменении суммы заблокированных средств следует учитывать, что такая возможность поддерживается не во всех случаях (в соответствии с региональными и другими особенностями) и с учётом ограничений со стороны платёжных систем (подробнее — в разделе Оплата в две стадии).
  2. Перейти на вкладку Массовые списания (Массовые отмены).

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

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

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

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

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

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

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

    Для этого можно контролировать статусы и индикаторы выполнения пакетов и статусы отдельных операций.

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

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

Управление подписками

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

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

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

  • Active — для действующих регулярных оплат, по которым автоматические списания выполняются по заданному расписанию.
  • Not set — для регулярных оплат, по которым не заданы условия автоматических списаний и эти списания не выполняются.
  • Deleted — для регулярных оплат, записи о которых были удалены и списания по которым не выполняются.
  • Cancelled — для регулярных оплат, в рамках которых отменены дальнейшие списания.
  • Undefined — для регулярных оплат, в рамках которых приостановлены дальнейшие списания, так как предыдущее списание отклонено.

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

При работе с интерфейсами Gate и Payment Page в запросе на проведение регистрационного платежа в объекте recurring передаётся идентификатор scheduled_payment_id, который затем присваивается регулярной оплате, а также указываются периодичность списания (параметр period) и дата первого списания (параметр start_date). В таком случае регулярная оплата считается действующей и в реестре подписок её статус обозначается как Active.

Если в запросе на проведение регистрационного платежа не был передан идентификатор scheduled_payment_id и не были заданы условия выполнения автоматических списаний, подписка обозначается в реестре статуcом Not set, а во вкладке Информация об операциях карточки подписки отображается предупреждение о том, что необходимо задать условия регулярной оплаты, чтобы выполнять автоматические списания.

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

Изменение условий подписки

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

  1. Открыть вкладку Настройки подписки карточки с детальной информацией о регулярной оплате и перейти в режим редактирования.

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

  2. Задать или изменить целевые параметры регулярной оплаты.

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

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

    • Если при регистрации регулярной оплаты не был задан её идентификатор (такая оплата отмечается статусом Not set), поле ID рекаррингового платежа является обязательным для заполнения. Если идентификатор уже задан, это поле недоступно для редактирования.
    • Поля для указания суммы списания, выбора периодичности регулярной оплаты и даты следующего списания являются обязательными для заполнения. Если хотя бы одно из этих полей не заполнено, при попытке сохранить внесённые в карточку изменения появляется сообщение об ошибке. Дата следующего списания не может предшествовать текущей дате, а также быть позже даты окончания действия регулярной оплаты.
    • Поля Валюта платежа и Дата завершения подписки недоступны для редактирования. Валюта платежа всегда соответствует валюте регистрационного платежа, а дата завершения подписки, если она не была указана в запросе на проведение регистрационного платежа, соответствует сроку действия карты, используемой для проведения регулярной оплаты.
    • Поле Описание не является обязательным.
    • При необходимости можно использовать кнопку Отменить, чтобы отказаться от внесения изменений в условия регулярной оплаты.
  3. Убедиться, что изменения были сохранены.

    Для этого можно проверить наличие соответствующей записи на панели История вкладки Настройки подписки, а также изменение статуса подписки с Not set на Active в реестре подписок.

Отмена дальнейших списаний

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

  1. Открыть вкладку Настройки подписки карточки с детальной информацией о регулярной оплате и выбрать действие отмены.

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

  2. Подтвердить отмену в появившемся модальном окне.
  3. Убедиться, что отмена выполнена.

    Для этого можно проверить наличие соответствующей записи на панели История вкладки Настройки подписки, а также изменение статуса отменённой подписки на Cancelled в реестре подписок.

Выполнение возвратов

Условия

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. Задать параметры выплаты и отправить запрос.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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. При этом каждый файл, используемый для массового добавления критериев должен удовлетворять следующим требованиям:

Каждый файл, используемый для проведения массовых платежей, должен удовлетворять следующим требованиям:
  • Должен использоваться формат CSV с кодировкой символов UTF-8 без использования маркеров очерёдности (Byte Order Mark, BOM).
  • Размер файла не должен превышать 128 MБ.
  • Первая строка должна содержать названия параметров, при этом названия могут указываться в любой последовательности.
  • Последующие строки должны содержать значения целевых параметров, при этом для необязательных параметров значения могут не указываться.
  • Все указываемые значения параметров в файле должны удовлетворять требованиям, представленным далее в таблице.
  • В случае, если названия и значения параметров операций задаются текстовыми строками (не в формате таблицы), в качестве разделителя значений параметров используется «;» (точка с запятой), при этом поля без значений разделяются точкой с запятой так же, как и поля со значениями и допускаются ситуации с идущими подряд двумя и более знаками «;», например:


    В случае подготовки файла в программе Microsoft Excel рекомендуется выполнять проверку в другом редакторе, например в «Блокноте».

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

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

Параметр Описание

operation_type
string, required

Тип операции: capture  (подтверждение списания заблокированных средств), cancel (отмена блокировки средств), refund (возврат) и payout  (выплата).
Пример: payout

general.project_id
integer, required

Идентификатор проекта, полученный от ECommPay при интеграции.
Пример: 35

method
string, required

Код платёжного метода для проведения платежа. Список этих кодов представлен в разделе Коды платёжных методов, поддерживаемых в Dashboard.
Пример: card

general.payment_id
string, required *

Идентификатор платежа, уникальный в рамках проекта.
Представляет собой строку длиной от 1 до 255 символов из любых букв, цифр или символов в кодировке UTF-8.
Пример: payment_536231.
* Для возврата необходимо указывать идентификатор той оплаты, по которой требуется выполнить этот возврат

payment.amount
integer, required

Сумма платежа в дробных единицах валюты.
Представляет собой число в диапазоне от 1 до 10000000000000 без разделителя между целой и дробной частями.
Пример: 1905 для суммы 19,05 и 190500 для суммы 1905

payment.currency
string, required

Код валюты платежа в формате ISO 4217 alpha-3.
Пример: EUR

payment.description
string, optional *

Описание платежа.
Представляет собой строку длиной не более 255 символов.
Пример: Deposit 12456.
* Этот параметр обязателен для возвратов

account.number
string, optional

Номер счёта пользователя веб-сервиса мерчанта.
Представляет собой строку длиной от 1 до 100 символов.
Пример: 1670033323

account.bank_id
integer, optional

Идентификатор банка, заданный в платёжной платформе ECommPay. Информацию о банках и их идентификаторах можно получить в описании платёжных методов в технической документации и у специалистов технической поддержки ECommPay.
Представляет собой число не менее 1.
Пример: 421

account.customer_name
string, optional

Полное имя владельца банковского счёта.
Представляет собой строку длиной не менее 1 символа.
Пример: John Johnson

account.branch
string, optional

Наименование филиала банка, в котором открыт счёт пользователя веб-сервиса мерчанта.
Представляет собой строку длиной не более 255 символов.
Пример: Bank branch

account.city
string, optional

Название города, в котором расположен филиал.
Представляет собой строку длиной не более 255 символов.
Пример: London

account.region_id
integer, optional

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

card.pan
integer, optional *

Номер карты пользователя веб-сервиса мерчанта.
Представляет собой число длиной не более 32 цифр.
Пример: 2333776109871312.
* Этот параметр обязателен для выплат по номеру карты

card.year
integer, optional *

Год истечения действия карты пользователя веб-сервиса.
Представляет собой число в диапазоне от 2020 до 9999.
Пример: 2024.
* Этот параметр является обязательным для выплат

card.month
integer, optional *

Порядковый номер месяца, в котором истекает срок действия карты пользователя веб-сервиса.
Представляет собой число в диапазоне от 1 до 12.
Пример: 12.
* Этот параметр обязателен для выплат

card.card_holder
string, optional *

Имя держателя карты.
Представляет собой строку длиной не более 255 символов.
Пример: John Johnson.
* Этот параметр обязателен для выплат

token
string, optional *

Токен платежного инструмента, полученный от ECommPay.
Пример: Z0yTL5shY8ddhpxdQyplRPJYmGV7Kv.
* Этот параметр обязателен для выплат по токену

customer.id
string, optional *

Идентификатор пользователя веб-сервиса в рамках проекта мерчанта.
Представляет собой строку длиной не более 255 символов.
Пример: customer313.
* Этот параметр обязателен для выплат

customer.country
string, optional *

Код страны проживания пользователя веб-сервиса в формате ISO 3166-1 alpha-2.
Пример: GB.
* Этот параметр обязателен для выплат

customer.city
string, optional *

Город проживания пользователя веб-сервиса.
Представляет собой строку длиной не более 255 символов.
Пример: London.
* Этот параметр обязателен для выплат

customer.state
string, optional

Регион (штат) расчётного адреса пользователя веб-сервиса.
Представляет собой строку длиной не более 255 символов.
Пример: West Midlands

customer.zip
string, optional

Почтовый индекс расчётного адреса пользователя веб-сервиса.
Представляет собой строку длиной не более 16 символов.
Пример: B152SA

customer.street
string, optional

Улица расчётного адреса пользователя веб-сервиса.
Пример: Edgbaston

customer.first_name
string, optional *

Имя пользователя веб-сервиса.
Представляет собой строку длиной не более 255 символов.
Пример: John.
* Этот параметр обязателен для выплат

customer.last_name
string, optional *

Фамилия пользователя веб-сервиса.
Представляет собой строку длиной не более 255 символов.
Пример: Johnson.
* Этот параметр обязателен для выплат

customer.day_of_birth
string, optional *

Дата рождения пользователя веб-сервиса, в формате ДД-ММ-ГГГГ.
Пример: 21-12-1989.
* Этот параметр обязателен для выплат

customer.phone
string, optional

Номер телефона пользователя веб-сервиса.
Представляет собой строку, состоящую из цифр, длиной от 4 до 24 символов и допускает использование символа «+» в начале строки.
Пример: 79105216611

customer.email
string, optional

Адрес электронной почты пользователя веб-сервиса.
Представляет собой строку длиной не более 255 символов.
Пример: test@mail.com

customer.ip_address
string, optional *

Используемый IP-адрес пользователя веб-сервиса.
Представляет собой строку длиной не более 255 символов.
Пример: 127.0.0.1.
* Этот параметр обязателен для выплат

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

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

Сообщение Причина
File is empty Файл пуст
Columns are duplicated Параметр указан более одного раза
File does not contain required columns Пропущены обязательные параметры
Incorrect file format Некорректное расширение или формат файла
File is broken Некорректная кодировка или структура данных
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) Указанный месяц действия карты истёк