# Контроль и проведение платежей {#ru_dbl_payments}

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

**На уровень выше:**[Dashboard](ru_dbl_about.md)

## Общая информация {#ru_dbl_payments_overview}

В интерфейсе Dashboard выделено несколько разделов для контроля и проведения платежей:

-   **Платежи** — для контроля проведения платежей всех типови выполнения отдельных операций, включая подтверждения и отмены списаний по двухстадийным оплатам, возвраты по оплатам любых типов и выплаты;
-   **Ссылки на оплату** — для работы с платёжными ссылками;
-   **Мануальные платежи** — для работы с одиночнымиоплатами MO/TO и выплатами, а также с групповыми подтверждениями и отменами списаний по двухстадийным оплатам и групповыми возвратами и выплатами;
-   **Подписки** — для работы с регулярными оплатами;
-   **Расчёты с партнёрами** — для работы c выплатами на счета юридических лиц \([подробнее](ru_b2bremit_about.md)\).

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

![](images/ecommpay/dbl/ru_dbl_overview.svg "Реестр платежей в разделе «Платежи»")

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

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

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

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

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

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

![](images/ecommpay/dbl/ru_dbl_payment_details.svg "Карточка платежа в разделе «Платежи»")

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

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

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

-   Информация в реестрах и карточках отображается с задержкой, которая может составлять до нескольких минут. При этом автоматическое обновление информации не поддерживается, но поддерживается обновление информации в реестре платежей с помощью кнопки ![](images/ecommpay/dbl/ru_icon_refresh.svg), расположенной в левом углу над реестром.
-   Состав и порядок столбцов в реестрах могут настраиваться, поэтому при наличии соответствующих прав можно оформлять реестры в соответствии с индивидуальными предпочтениями.
-   Ключевые атрибуты платежей — идентификатор, тип, статус, сумма и валюта — по умолчанию выводятся в первых столбцах реестров, и для этих атрибутов поддерживаются встроенные фильтры на панели фильтрации. При этом состав атрибутов и фильтров различается в зависимости от реестра.
-   В поле **Сумма** отображается *базовая сумма* платежа, по отношению к которой применим статус этого платежа.

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

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


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

## Проведение оплат {#ru_dbl_payments_purchases}

### Общая информация {#ru_dbl_payments_purchases_overview}

Интерфейс Dashboard позволяет:

-   Формировать и отправлять пользователям платёжные ссылки, а также управлять их действительностью — чтобы проводить по таким ссылкам разовые оплатыи регистрировать при этом регулярные \(когда это актуально\). Порядок проведения и возможные статусы оплат по платёжным ссылкам описаны [в модели](ru_platform_invoice_model.md).
-   Проводить оплаты MO/TO \(Mail Order / Telephone Order\) — с использованием платёжной формы и указанием реквизитов, предоставленных пользователями через электронную почту, телефон или иные средства связи.Такие оплаты проводятся как разовые в соответствии [с моделью](ru_platform_sms_model.md)и [с учётом ограничений](ru_Gate_moto.md).
-   Управлять списаниями по оплатам в две стадии — с возможностями применения единичной и пакетной отправки запросов для подтверждения списаний заблокированных средств и отмены их блокировки.Порядок проведения и возможные статусы оплат в две стадии описаны [в модели](ru_gate_payment_auth.md).

### Условия {#ru_dbl_payments_purchases_requirements}

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

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

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

### Оплаты по ссылкам {#ru_dbl_payments_purchases_payment_link_purchases}

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

![](images/ecommpay/dbl/ru_dbl_payment_invoice.svg "Указание основных параметров для проведения оплаты")

![](images/ecommpay/dbl/ru_dbl_payment_invoice_booking_info.svg "Указание сведений о бронировании")

![](images/ecommpay/dbl/ru_dbl_payment_subscription_via_invoice.svg "Указание параметров для проведения оплаты с регистрацией подписки")

![](images/ecommpay/dbl/ru_dbl_payment_invoice_complete.svg "Уведомление о создании ссылки")

![](images/ecommpay/dbl/ru_dbl_payment_invoice_registry.svg "Контроль проведения оплаты через реестр ссылок")

Чтобы провести разовую оплату с использованием платёжной ссылки\(и регистрацией регулярных списаний, если это актуально\), следует:

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

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

    Также эту вкладку можно открыть в разделе **Подписки** с помощью кнопки **Создать подписку**.

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

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

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

    -   сумма указывается с отделением дробной части с помощью точки \(например, `314.15`\);
    -   выбор платёжного метода становится доступным после указания идентификатора платежа и проекта;
    -   срок действия ссылки на оплату не должен превышать 30 суток;
    -   если включён переключатель **Отправить e-mail покупателю**, то при формировании платёжной ссылки она автоматически отправляется на указанный адрес электронной почты пользователя, если этот переключатель выключен — ссылку следует отправить пользователю самостоятельно;
    -   если регистрируются дальнейшие регулярные списания, на вкладке **Подписка** необходимо корректно указывать идентификаторы первичного платежа \(в поле **ID платежа**\) и платежа, в рамках которого должны выполняться дальнейшие списания \(в поле **ID рекаррингового платежа**\), — это разные идентификаторы, каждый из которых должен быть уникальным в рамках проекта;
    -   если регистрируются дальнейшие регулярные списания и при этом не указывается дата их окончания, то дата окончания определяется равной сроку действия указанной платёжной карты \(в случае с классической карточной оплатой\) или сроку в 10 лет с последнего дня месяца, в котором регистрируется эта повторяемая оплата \(в случае с любым из других платёжных методов\);
    -   если выбран платёжный метод **Card payments**, **Apple Pay**, **Google Pay** или **Click to Pay** и для проекта настроена обязательность указания дат начала и окончания бронируемой услуги, необходимо указывать эти даты \(это может быть актуально для мерчантов [с кодами категорий](ru_glossary.md) 3000–3999, 4411, 4511, 4722, 5962, 6513, 7011, 7012, 7512, 7519 и 7922; подробнее — у курирующего менеджера Ecommpay\)
    -   если выбран платёжный метод **Card payments**,рекомендуется указать адрес электронной почты — в случае его отсутствия соответствующая информация запрашивается у пользователя на этапе указания им платёжных данных;
    -   в случае некорректного заполнения полей отображаются уведомления об ошибках;
    -   кнопка **Создать ссылку на оплату** становится активной, когда корректно указаны обязательные параметры \(к ним не относятся описание платежа и адрес электронной почты, но эти поля желательно заполнять для минимизации рисков при проведении платежа\).
3.  При необходимости отправить пользователю платёжную ссылку.

    Это может быть актуально, например, если при заполнении формы не была включена автоматическая отправка. В таком случае, чтобы отправить ссылку, её необходимо скопировать в открывшемся окне с помощью кнопки ![](images/universal/dbl/icon_copy.svg) и отправить пользователю.

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

    При проведении разовой оплаты можно проверять её статус в реестре платежей или реестре оплат по платёжным ссылкам — этот статус должен принять значение `success`. Полный список возможных статусов для оплат по платёжным ссылкам представлен [в отдельной статье](ru_platform_invoice_model.md).

    Если оплата дополнительно регистрируется в качестве регулярной, то её статус можно проверять в разных реестрах: в реестре платежей он должен принять значение `scheduled recurring processing`, в реестре оплат по ссылке — `success`, в реестре подписок — `active`. Полный список возможных статусов регулярных оплат представлен [в отдельной статье](ru_platform_sheduled_recurring_model.md).

    После регистрации регулярной оплаты можно управлять условиями списаний по ней — при наличии соответствующих прав в интерфейсе Dashboard и в соответствии с процедурами, описанными [далее](ru_dbl_payments.md).


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

### Оплаты MO/TO {#ru_dbl_payments_purchases_moto}

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

1.  Перейти на вкладку **Виртуальный терминал**.

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

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

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

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

    -   идентификатор платежа должен быть уникальным в рамках указанного проекта;
    -   сумма указывается с отделением дробной части с помощью точки \(например, `314.15`\);
    -   кнопка **Оплатить** становится активной, когда указаны все обязательные параметры.
    ![](images/ecommpay/dbl/ru_dbl_payment_moto_initiation.svg)

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

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

    При использовании поля **Страна** необходимо указывать код страны в соответствии со стандартом ISO 3166-1 alpha-2; список таких кодов приведён в разделе [Коды стран](ru_country_codes.md)\).

    ![](images/ecommpay/dbl/ru_dbl_payment_moto_pp.svg)

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

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


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

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

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

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

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

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

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

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

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

        ![](images/ecommpay/dbl/ru_dbl_payment_capture_cancel.svg)

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

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

    3.  Подтвердить отправку запроса, щёлкнув кнопку **Списание** \(**Отмена**\).

        **Прим.:** Если кнопки **Списание** и **Отмена** не активны, это может свидетельствовать о том, что одна из этих операций уже выполняется, а если отсутствуют — о том, что для платежа не поддерживается выполнение таких операций.

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

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


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

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

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

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

    Требования к таким файлам представлены [далее](ru_dbl_payments.md).

    **Прим.:** При подготовке файла необходимо учесть, что в нём должны содержаться операции только одного типа — `capture` или `cancel`, а сумму подтверждения \(отмены\) может составлять как полная, так и частичная сумма заблокированных средств. При изменении суммы заблокированных средств следует учитывать, что такая возможность поддерживается не во всех случаях \(в соответствии с региональными и другими особенностями\) и с учётом ограничений со стороны платёжных систем \(подробнее — в разделе [Оплата в две стадии](ru_gate_payment_auth.md#section_flr_s1g_k3b)\).

2.  Перейти на вкладку **Массовые списания** \(**Массовые отмены**\).

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

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

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

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

    ![](images/ecommpay/dbl/ru_dbl_payment_capture_batch.svg)

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

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

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

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

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

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


## Управление подписками {#ru_dbl_payments_subscriptions}

### Общая информация {#ru_dbl_payments_subscriptions_overview}

Наряду с другими типами и категориями платежей платёжная платформа Ecommpay позволяет проводить *регулярные оплаты* — оплаты, в рамках каждой из которых со стороны мерчанта инициируется серия регулярных списаний с пользователя фиксированной суммы по заданному графику. Такие списания автоматически выполняются в платформе, а для пользователей обеспечивают возможность периодической оплаты *подписок* на определённые услуги со стороны мерчанта.

Интерфейс Dashboard позволяетрегистрировать регулярные оплаты и управлять их проведением. При этом можно:

-   задавать и изменять условия серии списаний,
-   контролировать выполнение списаний,
-   управлять повторными попытками отдельных списаний при их отклонении,
-   прекращать списания, когда они становятся неактуальными.

Для работы с этими возможностями в интерфейсе Dashboard выделен раздел **Подписки**, доступ к которому регулируется соответствующими правами \([подробнее](ru_dbl_roles_overview.md)\). В этом разделе доступны реестр и карточки платежей с информацией о регулярных оплатах.

**Прим.:** В интерфейсе Dashboard для обозначения регулярной оплаты могут использоваться термины *подписка*, *рекарринговый платёж* и *регулярный платёж* — как синонимы.

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

-   **Not set** — для регулярных оплат, по которым не заданы условия автоматических списаний и эти списания не выполняются\(в таких случаях в карточках этих оплат отображаются предупреждения о том, что необходимо задать условия списаний\).
-   **Active** — для действующих регулярных оплат, по которымзаданы условия автоматических списаний и эти списания выполняются по заданному расписанию.
-   **Cancelled** — для регулярных оплат, в рамках которых отменены дальнейшие списания.

![](images/ecommpay/dbl/ru_dbl_subscription.svg "Карточка подписки")

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

### Регистрация подписок {#ru_dbl_payments_subscriptions_creating}

Платёжная платформа Ecommpay позволяет регистрировать регулярные оплаты с автоматическими списаниями разными способами, в том числе при проведении платежей через Payment Page \([подробнее](ru_pp_recurring.md)\)и Gate \([подробнее](ru_gate_payment_recurring_registration.md)\), а также при переносе информации о повторяемых оплатах от других эквайеров \([подробнее](ru_gate_data_migration.md)\).

При работе с интерфейсом Dashboardрегистрировать регулярные оплаты можнос помощью платёжных ссылок, указывая соответствующую информацию при их создании \([подробнее](ru_dbl_payments.md)\).

### Указание условий {#ru_dbl_payments_subscriptions_updating}

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

1.  Открыть карточку целевой регулярной оплаты.

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

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

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

3.  Задать целевые параметры.

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

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

    -   Если при регистрации регулярной оплаты не был задан её идентификатор, поле **ID рекаррингового платежа** является обязательным для заполнения. Если идентификатор уже задан, это поле недоступно для редактирования.
    -   Поля для указания суммы списания, периодичности регулярной оплаты и даты следующего списания являются обязательными для заполнения. Если хотя бы одно из этих полей не заполнено, при попытке сохранить внесённые в карточку изменения появляется сообщение об ошибке.
    -   Дата следующего списания не может предшествовать текущей дате, а также быть позже даты окончания действия регулярной оплаты.
    -   Поля **Валюта платежа** и **Дата окончания подписки** недоступны для редактирования. Валюта списаний всегда соответствует валюте регистрационного платежа, а дата завершения подписки, если она не была указана в запросе на проведение регистрационного платежа, устанавливается согласно используемым в платформе правилам. Прекратить списания по подписке до завершения её срока можно через карточку подписки \([подробнее](ru_dbl_payments.md)\). Изменить срок действия подписки можно через соответствующую конечную точку Gate API \([подробнее](ru_gate_payment_recurring_manage.md#section_lpp_df2_5jb)\).
    -   Поля **Каждый\(е\)** \(для указания множителя к периоду списаний\) и **Описание** не являются обязательными.
    При необходимости можно отказаться от внесения изменений, используя кнопку **Отменить**.

4.  Убедиться, что изменения были сохранены.

    Для этого можно проверить наличие соответствующей информации в реестре записей об изменениях условий подписки\(щёлкнув кнопку **История настроек** на панели управления платежом\).


![](images/ecommpay/dbl/ru_dbl_subscription_edit.svg)

### Управление повторными попытками списаний {#ru_dbl_payments_subscriptions_retry}

#### Общая информация {#section_x3y_r1f_gzb .section}

При выполнении очередного списания в рамках повторяемой оплаты, как правило, достаточно одной попытки. Но в некоторых случаях, например при недостатке средств на счёте пользователя, могут быть уместны дополнительные попытки спустя определённое время. Для работы с такими ситуациями в платёжной платформе Ecommpay предусмотрена возможность автоматически инициировать повторные попытки списаний в рамках повторяемых оплат \(общая схема работы с такими попытками списаний представлена [в отдельной статье](ru_gate_cof_retry_attempts.md)\).

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

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

![](images/ecommpay/dbl/ru_dbl_temp_operation.svg "Работа со списанием")

![](images/ecommpay/dbl/ru_dbl_temp_retry.svg "Работа с повторной попыткой")

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

|Панель|для списаний|для повторных попыток|
|------|------------|---------------------|
|1. Панель со списком всех действий|содержит список списаний и возвратов по отдельной регулярной оплате \(при этом для каждого списания отображается его статус и может отображаться статус выполнения повторных попыток этого списания\)

|содержит список повторных попыток отдельного списания \(при этом для каждой попытки отображаются её статус и признак `retry operation`\)

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

|содержит  
 информацию об отдельной повторной попытке  
 \(включая признак `retry operation`\) и кнопку для возвращения к списку остальных операцийповторяемой оплаты

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

Статусы повторных попыток списаний могут принимать следующие значения:

-   `retries active` — в платформе запланирована повторная попытка\(при отклонении очередного списания на стороне платёжной системы или эмитента\);
-   `retry in progress` — повторная попытка выполняется;
-   `retries successful` — одна из повторных попыток привела к переводу средствот пользователя к мерчанту;
-   `retries unsuccessful` — все доступные повторные попытки были отклонены;
-   `retries cancelled` — дальнейшие повторные попытки отменены\(по запросу мерчанта или автоматически, с учётом изменения свойств повторяемой оплаты или иных факторов\).

#### Настройка графика попыток {#section_qbr_422_phc .section}

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

График любого проекта можно менять, настраивая индивидуальные параметры или сбрасывая их значения к базовым. При этом стоит учитывать, что каждая повторная попытка, которая относится к целевому проекту ибыла запланирована при отклонении исходной или очередной попытки списаниядо изменения графика, выполняется согласно запланированным дате и времени\(по предыдущему графику\), но если какая-либо из таких попыток отклоняется уже после изменения графика и в платёжной платформе подтверждается возможность выполнить следующую попытку этого списания, то новая попытка планируется и выполняется по обновлённому графику.И в любом случае информация о каждой последующей попытке направляется к веб-сервису в оповещении об отклонении очередной попытки списания \([подробнее](ru_gate_cof_retry_attempts.md)\).

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

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

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

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

    Для использования графика по умолчанию необходимо выбрать вариант **Стандартный график повторных попыток подписок**.

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

3.  Сохранить изменения, щёлкнув кнопку **Сохранить**.

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

4.  Убедиться, что обновлённый график сохранён.

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


![](images/ecommpay/dbl/ru_dbl_payments_custom_subscription_schedule.svg "Настройка графика повторных попыток")

#### Контроль попыток {#section_dny_w1f_gzb .section}

Интерфейс Dashboard позволяет контролировать информацию о выполнении повторных попыток в рамках регулярных списаний. Для этогов реестрах платежей доступны карточки повторяемых оплат с информацией об относящихся к ним списаниям и повторным попыткам конкретных списаний\([подробнее](ru_dbl_payments.md#section_x3y_r1f_gzb)\).

Чтобы получить информацию о повторных попытках конкретного списания, следует:

1.  Открыть карточку целевой регулярной оплаты.

    Для этого можно воспользоваться поиском \(например, по идентификатору платежа\) либо перейти в раздел **Подписки** или **Платежи** и использовать реестр и фильтры.

2.  Перейти к информации о целевом списании.

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

3.  Открыть список повторных попыток целевого списания.

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

4.  Перейти к детальной информации о целевой повторной попытке.

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

5.  При необходимости, вернуться к списку остальных списаний.

    Для этого следует щёлкнуть кнопку **Вернуться к основной операции** на панели управления отдельной повторной попыткой или щёлкнуть кнопку ![](images/universal/dbl/icon_back.svg) в верхнем правом углу панели со списком повторных попыток.


#### Отмена дальнейших попыток {#section_tcz_fbf_gzb .section}

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

1.  Открыть карточку целевой регулярной оплаты.

    Для этого можно воспользоваться поиском \(например, по идентификатору платежа\) либо перейти в раздел **Подписки** или **Платежи** и использовать реестр и фильтры.

2.  Перейти к информации о целевом списании.

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

3.  Отменить выполнение повторных попыток.

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

4.  Убедиться, что выполнение дальнейших попыток отменено.

    Для этого необходимо проверить их статус в строке списания на панели с операциями повторяемой оплаты — он должен измениться с `active` на `retries cancelled`.


### Прекращение списаний {#ru_dbl_payments_subscriptions_cancelling}

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

1.  Открыть карточку целевой регулярной оплаты.

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

2.  Перейти к свойствам оплаты и инициировать прекращение списаний.

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

3.  Подтвердить прекращение списаний в появившемся модальном окне.
4.  Убедиться в отмене дальнейших списаний.

    Для этого можно проверить наличие соответствующей информации в реестре записей об изменениях условий подписки \(щёлкнув кнопку **История настроек** на панели управления платежом\), а также изменение статуса на `Cancelled` в реестре подписок.

    ![](images/ecommpay/dbl/ru_dbl_subscription_history.svg)


## Выполнение возвратов {#ru_dbl_payments_refunds}

### Условия {#section_vvh_kdx_31c .section}

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

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

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

### Одиночные возвраты {#section_cs1_ldx_31c .section}

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

![](images/ecommpay/dbl/ru_dbl_refund_in_registry.svg "Инициирование возврата из реестра платежей")

![](images/ecommpay/dbl/ru_dbl_payment_refund.svg "Инициирование возврата из карточки оплаты")

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

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

    Для этого можно воспользоваться поиском \(например, по идентификатору платежа\) или перейти в раздел **Платежи** и использовать реестр и фильтры \(например, по типу платежа — `purchase`, `recurring`, `invoice` или `account verification`\).

2.  Открыть окно инициирования возврата.

    Для этого можно щёлкнуть кнопку ![](images/universal/dbl/icon_refund.svg) в соответствующей строке реестра платежей или открыть карточку платежа и щёлкнуть кнопку **Возврат**, расположенную на панели управления платежом или на панели информации об отдельной операции повторяемой оплаты.

    **Прим.:** Если кнопка **Возврат** не активна, это может свидетельствовать о том, что оплата ещё не проведена, а если отсутствует — о том, что для используемого платёжного метода не поддерживается выполнение возвратов \(в таких случаях можно обращаться за консультацией к курирующему менеджеру Ecommpay\).

3.  Инициировать выполнение возврата.

    Для этого необходимо указать в открывшемся окне требуемую сумму возврата — полную доступную или её часть \(сумма, доступная для возврата, отображается в этом же окне\) и щёлкнуть кнопку **Возврат**.

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

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

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


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

### Массовые возвраты {#section_uyq_ldx_31c .section}

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

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

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

    **Прим.:** При подготовке файла необходимо учитывать, что для выполнения возврата на оплату в поле `general.payment_id` должен быть указан её идентификатор, а для возврата на отдельную операцию в рамках повторяемой оплаты дополнительно в поле `general.operation_id` должен быть указан идентификатор этой операции.

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

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

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

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

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

    ![](images/ecommpay/dbl/ru_dbl_mass_refund.svg)

4.  Отправить пакет запросов на выполнение, щёлкнув кнопку **Отправить запрос**.
5.  Убедиться в выполнении запросов.

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

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

    ![](images/ecommpay/dbl/ru_dbl_payment_mass_refund.svg)


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

## Проведение выплат {#ru_dbl_payments_payouts}

### Условия {#ru_dbl_payments_payouts_overview}

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

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

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

### Одиночные выплаты {#ru_dbl_payments_payouts_single}

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

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

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

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

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

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

    -   сумма указывается с отделением дробной части с помощью точки \(например, `314.15`\);
    -   поля для специфических параметров разных платёжных методов отображаются после указания проекта, суммы, валюты и платёжного метода;
    -   в числе специфических полей отображаются только обязательные для заполнения;
    -   в случае некорректного заполнения полей отображаются уведомления об ошибках;
    -   кнопка **Отправить запрос** становится активной, когда корректно указаны все параметры.
    ![](images/ecommpay/dbl/ru_dbl_payment_payout.svg)

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

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

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

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

    ![](images/ecommpay/dbl/ru_dbl_payment_payout_clarification.svg)

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

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


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

### Массовые выплаты {#ru_dbl_payments_payouts_mass}

#### Основная процедура {#section_xjl_fy3_vnb .section}

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

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

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

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

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

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

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

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

    ![](images/ecommpay/dbl/ru_dbl_mass_payout.svg)

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

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

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

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

    ![](images/ecommpay/dbl/ru_dbl_payment_mass_refund.svg)


#### Дополнение информации {#section_opk_mwj_zsb .section}

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

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

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

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

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

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

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

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

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

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

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

    Это можно сделать непосредственно через интерфейс Dashboard, введя данные в ячейки со значком ![](images/universal/dbl/icon_pencil.svg), либо через обновление файла. Во втором случае необходимо выгрузить файл, используя кнопку ![](images/universal/dbl/icon_file_download.svg), указать в этом файле требуемые параметры в ячейках со значением `*required*` и загрузить дополненный файл, используя кнопку ![](images/universal/dbl/icon_file_upload.svg).

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

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

    ![](images/ecommpay/dbl/ru_dbl_masspayouts_clarification.svg)

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

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

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

## Сведения о массовых платежах {#ru_dbl_payments_mass_info}

### Требования к файлам {#ru_dbl_payments_mass_info_requirements}

Для подготовки файла массовых платежей можно использовать шаблон, доступный для скачивания в интерфейсе Dashboard на вкладке массового добавления или [по ссылке](files_for_downloads/dashboard/TemplateMassPayments.csv).После загрузки шаблона его можно заполнить в любом редакторе файлов формата CSV, например, MS Excel. При этом каждый файл должен удовлетворять следующим требованиям:

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

    ![](images/universal/dbl/ru_dbl_file_data_as_string.png)

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


### Используемые параметры {#ru_dbl_payments_mass_info_parameters}

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

|Параметр|Описание|
|:-------|--------|
|operation\_type  
 string, required

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

|
|general.project\_id  
 integer, required

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

|
|method  
 string, required

|Код платёжного метода для проведения платежа.Список этих кодов представлен в разделе [Коды платёжных методов](ru_pm_codes.md).  
 Пример: `card`

|
|general.payment\_id  
 string, required \*

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

|
|general.operation\_id  
 string, required \*

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

|
|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

|Почтовый индекс расчётного адреса пользователя веб-сервиса.   
 Представляет собой строку длиной не более 10 символов.  
 Пример: `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 символов и допускает использование символа «+» в начале строки.  
 Пример: `79105216601`

|
|customer.email  
 string, optional

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

|
|customer.ip\_address  
 string, optional \*

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

|

### Возможные ошибки {#ru_dbl_payments_mass_info_errors}

При проверке файлов, загружаемых через 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\)|Указанный месяц действия карты истёк|