Подготовка со стороны Apple Pay и Adyen

Платежная система Apple Pay добавлена в Bitrix Framework начиная с версии 20.0.400 модуля Интернет-магазин и работает через обработчик Adyen.

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

• иметь (или создать новый) аккаунт разработчика Apple Pay;
• создать аккаунт в Adyen (для тестирования можно сделать специальный тестовый аккаунт);
• настроить эти аккаунты в соответствии с инструкцией.

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

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

Подробнее... новую платежную систему:

1. В открывшейся форме в поле обработчик выберите Adyen (adyen). После выбора обработчика тип платежной системы и еще часть полей заполнятся автоматически:

   

2. В поле кодировка укажите UTF-8 и заполните остальные параметры При создании платежной системы обратите внимание на настройку следующих полей:
   Подробнее... платежной системы;
3. В разделе Подтверждение владения доменом кликните по ссылке Форма подтверждения домена, а в появившемся слайдере выберите сайт своего магазина и прикрепите файл При выполнении четвертого шага инструкции вы регистрировали домен своего интернет-магазина. После этой регистрации вам стал доступен для скачивания файл. Его нужно скачать и прикрепить в настройках платежной системы. из личного кабинета разработчика Apple Pay:

   

  Настройка обработчика ПС

Настройки подключения Adyen:

• Adyen ID – идентификатор аккаунта в Adyen;
• API key – ключ для аутентификации в Adyen;

  Как сгенерировать API key
  1. Перейдите на страницу аккаунта: Account > Users (выбрать пользователя – тип пользователя Web Service); 2. В блоке Authentication кликните Generate API Key:

• HMAC key – ключ HMAC HMAC (сокращение от англ. hash-based message authentication code, код аутентификации (проверки подлинности) сообщений, использующий хеш-функции) — в информатике (криптографии), один из механизмов проверки целостности информации, позволяющий гарантировать то, что данные, передаваемые или хранящиеся в ненадёжной среде, не были изменены посторонними лицами.
  
  Подробнее... для обеспечения проверки подлинности и целостности информации;

  Как настроить Callback уведомления и получить HMAC key

  1. Перейдите на страницу аккаунта: Account > API URLs и откройте вкладку Additional data settings. Отметьте следующие настройки: Payment Account Reference: on Recurring details: on Merchant reference: on 2. Теперь перейдите на страницу Account > Server communication (выберите нужный аккаунт) и добавьте Standard Notification: В его настройках укажите: URL: https://#ваш_сайт#/bitrix/tools/sale_ps_result.php SSL Version: TLSv1.2 Method: JSON Add Acquirer Result: on Add Payment Account Reference: on HMAC Key: Generate HMAC key Include Metadata in payment notification for 3D Secure payments (notifications are not sent from Pal): on Для сохранения настроек нажмите Save Configuration.

• Автоматически оплачивать заказ при получении успешного статуса оплаты – используется для смены статуса при Callback уведомлениях;
• Live URL prefix – значение префикса, полученное от менеджера Adyen для “боевого” аккаунта;
• Тестовый режим – используется для тестирования, в этом режим Live URL prefix не используется;

Настройки подключения Apple Pay:

• Merchant ID – идентификатор продавца ApplePay;
• Название магазина – любое название магазина, которое будет отображаться в платёжной форме Apple Pay;
• Сертификат обработки платежей – сертификат в формате .pem, полученный на этапе подготовки со стороны Apple Pay и Adyen;
• Домен – укажите домен, для которого выдан сертификат;
• Двухбуквенный код страны по стандарту ISO 3166 – укажите двухбуквенный код страны, в которой будет обрабатываться платеж. Проконсультируйтесь с вашим поставщиком платежных услуг (Payment Service Provider, PSP), чтобы определить, какое значение использовать.

Примечание: Если у Вас не отображается какая-либо из указанных выше настроек, то воспользуйтесь кнопкой Показать все.

  Тестирование

Для тестирования нужно воспользоваться "песочницей" Apple Pay:

• Со стороны Apple нужно добавить тестовый аккаунт в "песочницу" и зайти под этим аккаунтом на одно из устройств, поддерживающее платежи.
• Также необходимо выполнение следующих требований:
  • операционная система iOS 11.3 и выше;
  • операционная система macOS 10.12.6 и выше, версия браузера Safari 11.1 и выше;
  • Со стороны Adyen нужно использовать тестовый аккаунт;
  • Со стороны сайта в настройках платежной системы нужно отметить Тестовый режим.