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

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

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

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

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

Структура правил и особенности их применения

Каждое правило определяет, при выполнении какого набора условий на какой адрес отправлять оповещения. В наборе условий задаются тип платежа, тип события (Тип результата в интерфейсе 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 оповещения о выполнении очередного списания в рамках повторяемых оплат должны отправляться на оба адреса, так как этот набор условий соответствует обоим правилам.
  
  
• Если при деактивации или удалении правила есть действующие правила с аналогичными условиями, то оповещения отправляются на адреса, указанные в этих правилах, иначе — отправка оповещений для заданных условий прекращается.

Управление правилами

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

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

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

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

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

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

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

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

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

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

Ограничения

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

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

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

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

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

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

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

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

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

   Для этого необходимо указать для каждого домена его полное доменное имя (fully qualified domain name, включая домены всех уровней, например www.traveltowels.cosmoshop.vrg) в поле Доменное имя и подтвердить добавление, щёлкнув кнопку . При этом следует учитывать, что за один раз можно добавлять не более десяти доменных имён, а некорректно указанные имена можно удалять с помощью кнопки .

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

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

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

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

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

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

Дополнительные материалы

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

• Apple Pay — о платёжном методе Apple Pay и особенностях работы с ним;
• Открытие в элементе iframe HTML-страницы — об открытии платёжной формы Payment Page в элементе iframe;
• Открытие в модальном окне — об открытии платёжной формы Payment Page в модальном окне.