# Управление проектами {#ru_dbl_projects}

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

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

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

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

![](images/ecommpay/dbl/ru_dbl_projects.svg "Карточка проекта")

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

-   **Общие** — для просмотра основных сведений о проекте и управления секретным ключом проекта, который обязателен для проведения оплат MO/TO через интерфейс Dashboard;
-   **Платёжные методы** — для просмотра списка подключённых платёжных методовс возможностью запросить подключение ApplePay и PayPal;
-   **Ссылки для перенаправления** — для настройки адресов возвращения пользователей к веб-сервису при работе с Payment Page \([подробнее](ru_PP_redirect_modes.md#)\);
-   **Оповещения** — для настройки правил отправки оповещений;
-   **Payment Page Designer** — для настройки индивидуального оформления Payment Page \([подробнее](ru_PP__design_customisation.md#)\);

    **Прим.:** Вкладка **Payment Page Designer** не отображается при работе с мобильных устройств.

-   **Верификация доменов для Apple Pay** — для регистрации доменов в сервисе Apple Pay и управления ими;
-   **Настройки повторных попыток подписок** — для настройки отдельного графика повторных попыток списаний \(действительного для каждой регулярной оплаты в рамках конкретного проекта\).

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

## Работа с правилами отправки оповещений {#ru_dbl_projects_callbacks}

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

При проведении платежей через платформу Ecommpay к веб-сервису мерчанта отправляются оповещения, например с информацией для перенаправления пользователей или с информацией о результатах выполнения операций. Структура этих оповещений и работа с ними описаны в статье [Работа с оповещениями](ru_platform_callbacks.md#).

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

![](images/ecommpay/dbl/ru_dbl_projects_callbacks.svg "Инструменты для управления правилами")

### Структура правил и особенности их применения {#section_rns_lbc_nsb .section}

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

-   типы платежей `purchase, recurring, payout, account verification` и `all` \(для всех перечисленных типов\);
-   типы событий `success, decline, tokenize, refund, recurring, error` и `all` \(для всех перечисленных типов\);
-   коды платёжных методов, подключённых к проекту, или пустое значение \(для всех подключённых методов\).

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

-   В реестре отображаются правила отправки оповещений для всех указанных типов платежей и событий, но управление некоторыми из этих правил осуществляется только через сотрудников технической поддержки Ecommpay. К таким правилам относятся правила для оповещений с нетиповыми форматами.
-   Каждое правило для платежей типа `purchase` действует как для одностадийных, так и для двухстадийных оплат, поэтому каждое такое правило в реестре разбивается на два — для типов платежей `purchase` и `purchase_dms`. При необходимости избыточные правила можно удалять.
-   Настройка отправки оповещений с типом события `error` поддерживается только для платежей всех типов \(`all`\).
-   Если одному набору условий соответствует несколько правил с разными адресами, то оповещения дублируются на все эти адреса — без какого-либо приоритета и независимо от способа указания адресов \(при интеграции или через Dashboard\).Так, для представленных на изображении правил `96071` и `96081` оповещения о выполнении очередного списания в рамках повторяемых оплат должны отправляться на оба адреса, так как этот набор условий соответствует обоим правилам.

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

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

### Управление правилами {#section_exb_wbc_nsb .section}

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

1.  Выбрать целевой проект.

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

2.  Открыть вкладку **Оповещения** в левой части карточки проекта.
3.  Задать правило с учётом условий, описанных вместе со структурой правил.

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

4.  Сохранить правило, щёлкнув кнопку **Сохранить**.

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


Чтобы активировать или деактивировать отдельное правило, следует использовать переключатель **Статус** в соответствующей строке реестра.

Чтобы удалить отдельное правило, следует щёлкнуть кнопку ![](images/universal/dbl/icon_trashbin.svg) в соответствующей строке реестра и подтвердить действие.

## Работа с доменами для сервиса Apple Pay {#ru_dbl_projects_apple_pay_domain_verification}

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

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

![](images/ecommpay/dbl/ru_dbl_projects_domains.svg "Форма регистрации доменов")

### Ограничения {#section_c5n_j3d_3gc .section}

При регистрации доменов для работы с методом Apple Pay через платёжную форму Payment Page \(с её открытием в элементе iframe или модальном окне\) необходимо учитывать следующие ограничения:

-   Должны регистрироваться все домены, в рамках которых предполагается использование платёжной формы с поддержкой платёжного метода Apple Pay.При этом под доменом подразумевается домен с полным доменным именем \(fully qualified domain name\), включающим имена доменов всех уровней, от нижнего до верхнего. Если какой-либо из доменов не зарегистрирован, то платёжный метод Apple Pay остаётся доступным в платёжной форме Payment Page, но попытки оплаты этим методом отклоняются.
-   Могут регистрироваться только те домены, которые учтены в договорных отношениях с Ecommpayили отдельно согласованы с курирующим менеджером Ecommpay.
-   Может использоваться только файл верификации от Ecommpay \(подробнее [далее](ru_dbl_projects.md#section_rns_lbc_nsb)\).Использование файлов верификации от третьих сторон для работы с платёжной формой Payment Page от Ecommpay недопустимо.
-   Файлы верификации должны располагаться строго по указанным адресам на зарегистрированных доменах, без изменений этих адресов и перенаправлений к другим ресурсам.

### Управление составом доменов {#section_rns_lbc_nsb .section}

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

1.  Выполнить подготовительные технические работы.

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

    1.  Скачать файл верификации доменов `apple-developer-merchantid-domain-association` [из репозитория Ecommpay](https://paymentpage.ecommpay.com/.well-known/apple-developer-merchantid-domain-association).
    2.  Разместить скачанный файл верификации на каждом из актуальных доменов — в папке `.well-known`, размещённой в корневой папке домена \(таким образом, чтобы полный URL для этого файла выглядел как `https://<fully qualified domain name of your service>/.well-known/apple-developer-merchantid-domain-association`\).
    3.  Внести в число доверенных IP-адресов для каждого домена адреса, используемые сервисом Apple Pay для верификации доменов и проведения платежей \([подробнее](https://developer.apple.com/documentation/apple_pay_on_the_web/setting_up_your_server)\).
2.  Открыть интерфейс Dashboard.
3.  Открыть форму регистрации доменов.

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

4.  Выбрать актуальное юридическое лицов выпадающем списке **Юридическое лицо**.
5.  Указать актуальные доменные имена.

    Для этого необходимо указать для каждого домена его полное доменное имя \(fully qualified domain name, включая домены всех уровней, например `www.traveltowels.cosmoshop.vrg`\) в поле **Доменное имя** и подтвердить добавление, щёлкнув кнопку ![](images/ecommpay/dbl/icon_add.svg). При этом следует учитывать, что за один раз можно добавлять не более десяти доменных имён, а некорректно указанные имена можно удалять с помощью кнопки ![](images/universal/dbl/icon_trashbean2.svg).

6.  Отправить запрос на регистрацию доменов, щёлкнув кнопку **Сохранить**.

    **Прим.:** Если кнопка **Сохранить** не активна, это может быть вызвано тем, что не выбрано **Юридическое лицо** либо не заполнено хотя бы одно **Доменное имя**.

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

    В случаях, когда устранить неполадки не удаётся самостоятельно, можно обращаться к специалистам технической поддержки Ecommpay.

7.  Убедиться, что домены зарегистрированы.

    Для этого можно проверить наличие соответствующих записей в реестре доменов на вкладке **Верификация доменов для Apple Pay**.


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

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

### Дополнительные материалы {#section_xpz_thl_ggb .section}

Для организации работы с методом Apple Pay при указанных вариантах открытия Payment Page также могут быть полезны следующие материалы:

-   [Apple Pay](pm_applepay.md#)— о платёжном методе Apple Pay и особенностях работы с ним;
-   [Открытие в элементе iframe HTML-страницы](ru_PP_method_Embedded.md#)— об открытии платёжной формы Payment Page в элементе iframe;
-   [Открытие в модальном окне](ru_PP_method_ModalWindow.md#)— об открытии платёжной формы Payment Page в модальном окне.