Apple Pay

Введение

Если ваша платежная страница находится на стороне платежного шлюза, платежи Apple Pay будут работать без каких-либо дополнительных действий с вашей стороны, поскольку вы автоматически регистрируетесь в Apple с доменом платежного шлюза по умолчанию.

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

Создание Merchant ID

Чтобы создать свой Merchant ID (Идентификатор продаваца), выполните следующие действия.

1. В личном кабинете Apple Member Center перейдите по ссылке Certificates, Identifiers & Profiles.
2. На отобразившейся странице в секции Identifiers выберите Merchant IDs.
3. На отобразившейся странице нажмите на значок + в правом верхнем углу.
4. В полях Merchant ID Descritpion и Identifier введите описание своего идентификатора продавца Apple и сам идентификатор соответственно.
   
5. Нажмите Continue.
6. На отобразившейся странице проверьте введенные данные и нажмите Register.
7. На отобразившейся странице нажмите Done.

Регистрация сертификата

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

Создание нового сертификата

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

1. Зайдите в личный кабинет и выберите раздел Сертификаты в левом боковом меню.
2. Выберите Apple Pay.
3. Нажмите Создать пару ключей.
   Отобразится следующее окно.
   
4. Заполните необходимые поля (см. таблицу ниже).

• После внесения необходимых изменений нажмите Создать.

Созданная пара ключей будет отображаться в разделе Apple Pay (см. рисунок ниже).

Переходите к выгрузке CSR.

Загрузка ранее созданного сертификата

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

1. Зайдите в личный кабинет и выберите раздел Сертификаты в левом боковом меню.
2. Выберите Apple Pay.
3. В секции Apple Identity нажмите Добавить ключ.
   Отобразится следующее окно.
   
4. Заполните поля:
   • Apple ID - Укажите Merchant Apple ID.
   • Пароль - Введите пароль, защищающий содержимое файла PKCS12.
   • Домен по умолчанию - введите домен вашего интернет-магазина.
5. Перетащите файл ключевой пары в предназначенную для этого область.
   Он отобразится в списке.
   
6. Нажмите Подтвердить. Импортированный сертификат отобразится в списке Apple Identity.

Далее с сертификатом доступны следующие действия.

• Редактирование Apple Merchant ID
• Установка запрета на использование сертификата

Экспорт запроса подписи сертификата (CSR)

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

1. Зайдите в личный кабинет и выберите в левом боковом меню (раздел Сертификаты)
   1. Выберите нужный платежный сервис (Apple Pay, Google Pay или Samsung Pay).
   2. Нажмите на три точки в строке с нужным сертификатом и выберите Выгрузить ключ (см. изображение ниже).
      
      Отобразится окно сохранения файла.
   3. Укажите путь сохранения файла или сохраните его в папку по умолчанию.

Также вам доступны следующие действия.

• Редактирование Apple Merchant ID
• Установка запрета на использование сертификата

Редактирование Merchant ID

Чтобы изменить свой Apple Merchant ID, выполните следующие действия.

1. Зайдите в личный кабинет и выберите раздел Сертификаты в левом боковом меню.
2. Выберите Apple Pay.
3. Нажмите и выберите Редактировать (см. рисунок ниже).
   
   Отобразится следующее окно.
   
4. Отредактируйте поле Apple ID и нажмите Подтвердить.

Отключение сертификата

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

1. Зайдите в личный кабинет и выберите в левом боковом меню (раздел Сертификаты)
   1. Выберите нужный платежный сервис (Apple Pay, Google Pay или Samsung Pay).
   2. Нажмите на значке в строке нужного сертификата и выберите Запретить использование (см. изображение ниже).
      
      Отобразится следующее окно.
      
   3. Нажмите Подтвердить.

Отображение сертификата, использование которого запрещено, зависит от фильтра Разрешен, расположенного в верхней части раздела Сертификаты (см. изображение ниже).

Параметр	Описание
Только разрешенные	Сертификаты, использование которых запрещено, не отображаются в списке сертификатов.
Все позиции	Сертификаты, использование которых запрещено, отображаются в списке, но в столбце Разрешен напротив этого сертификата значится Нет (см. изображение ниже).

Действия, необходимые для веб-интеграции

Чтобы обеспечить возможность веб-интеграции, выполните следующие действия.

1. Зарегистрируйте и подтвердите свой домен в Apple.
2. Создайте сертификат идентификации продавца, преобразуйте его в .pem файл и загрузите его на свой сервер.

Этот сертификат используется для аутентификации подключений к серверам Apple Pay.

Регистрация домена в Apple

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

1. Войдите в свою учетную запись разработчика Apple на странице https://developer.apple.com.
2. Следуйте инструкциям справки учетной записи разработчика Apple, чтобы зарегистрировать домен.

На шаге выбора идентификатора продавца, выберите созданный ранее идентификатор продавца.

Схема интеграции

1. Пользователь в мобильном приложении выбирает вариант оплаты с помощью Apple Pay.
2. Сведения о платеже направляются на обработку в систему Apple Pay.
3. Для обработки данных о платеже в системе Apple Pay создается объект PKPaymentToken Object, который содержит свойство paymentData (здесь и далее см. документацию Apple Pay).
4. Apply Pay направляет продавцу (мобильному приложению) ответ.
5. Продавец извлекает из полученного объекта PKPaymentToken Object свойство paymentData и кодирует его содержимое в Base64.
6. Продавец создает запрос на оплату, содержащий в том числе свойство paymentData, полученное из ответа системы Apple Pay и закодированное в Base64, и отправляет его на обработку в платежный шлюз (см. запрос на оплату через Apple Pay).
7. Платежная система обрабатывает запрос.
8. Платежная система возвращает ответ с результатом.
9. Мобильное приложение отображает пользователю результат оплаты.

Cсылки на справочную информацию

Samsung Pay

## Общая информация [#samsungpay-general-info]

Перед тем, как принимать платежи через Samsung Pay, выполните следующие действия.

1. Заведите учетную запись на сайте https://account.samsung.com.
2. Используя созданную учетную запись, зарегистрируйтесь на сайте https://pay.samsung.com/developers.
3. На сайте https://pay.samsung.com/developers создайте Service (Сервис) и в качестве Payment Gateway (Платежный шлюз) выберите BPC.
4. Переходите к действиям в личном кабинете платежного шлюза:
   • создание ключевой пары
   • экспорт запроса подписи сертификата.

## Создание ключевой пары [#key-pair-creation-samsungpay]

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

1. Зайдите в личный кабинет и выберите раздел Сертификаты в левом боковом меню.
2. Выбор оплаты Samsung Pay.
3. В разделе Работа с ключами нажмите Создать пару ключей.
   Отобразится следующее окно.
   
4. Заполните поля (см. таблицу ниже).

• После внесения необходимых изменений нажмите Создать.

Созданная пара ключей будет отображаться в разделе Работа с ключами (см. рисунок ниже).

Переходите к выгрузке CSR.

## Экспорт запроса подписи сертификата (CSR) [#download-csr-samsungpay]

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

1. Зайдите в личный кабинет и выберите в левом боковом меню (раздел Сертификаты)
   1. Выберите нужный платежный сервис (Apple Pay, Google Pay или Samsung Pay).
   2. Нажмите на три точки в строке с нужным сертификатом и выберите Выгрузить ключ (см. изображение ниже).
      
      Отобразится окно сохранения файла.
   3. Укажите путь сохранения файла или сохраните его в папку по умолчанию.

Теперь вы можете загрузить запрос подписи сертификата в личном кабинете Samsung Pay.

Также вы можете установить запрет на использование сертификата.

## Заверешение регистрации [#samsungpay-complete-registration]

В личном кабинете на сайте https://pay.samsung.com/developers загрузите запрос подписи сертификата в качестве Merchant CSR (Запрос подписи сертификата продавца).

## Отключение сертификата [#disable-key-samsungpay]

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

1. Зайдите в личный кабинет и выберите в левом боковом меню (раздел Сертификаты)
   1. Выберите нужный платежный сервис (Apple Pay, Google Pay или Samsung Pay).
   2. Нажмите на значке в строке нужного сертификата и выберите Запретить использование (см. изображение ниже).
      
      Отобразится следующее окно.
      
   3. Нажмите Подтвердить.

Отображение сертификата, использование которого запрещено, зависит от фильтра Разрешен, расположенного в верхней части раздела Сертификаты (см. изображение ниже).

Параметр	Описание
Только разрешенные	Сертификаты, использование которых запрещено, не отображаются в списке сертификатов.
Все позиции	Сертификаты, использование которых запрещено, отображаются в списке, но в столбце Разрешен напротив этого сертификата значится Нет (см. изображение ниже).

Схемы интеграции

• Схема взаимодействия при оплате из мобильного приложения
• Схема взаимодействия при оплате с веб-страницы (платежная форма на стороне платежного шлюза)
• Схема взаимодействия при оплате с веб-страницы (платежная форма на стороне продавца)

Оплата из мобильного приложения

1. Клиент выбирает выбирает способ оплаты Samsung Pay.
2. Приложение отправляет сведения о платеже в Samsung.
3. Samsung проверяет приложение.
4. Samsung отправляет в приложение ответ содержащий, среди прочего, параметр 3ds.data с зашифрованными данными о платеже.
5. Продавец отправляет в платежный шлюз запрос на оплату. Параметр 3ds.data включает содержимое paymentToken, полученное от Samsung.
6. Платежный шлюз расшифровывает содержимое paymentToken и производит оплату.
7. Платежный шлюз отправляет в приложение результат оплаты.
8. Приложение отображает клиенту результат оплаты.

Оплата с веб-страницы на стороне платежного шлюза

1. Пользователь на сайте формирует заказ и начинает процедуру оплаты.
2. Продавец направляет в платежный шлюз запрос на регистрацию заказа:
   • Одностадийная оплата;
   • Двухстадийная оплата.
3. Продавец отправляет в платежный шлюз запрос на оплату.
4. Клиент выбирает оплату через Samsung Pay.
5. Платежный шлюз обменивается данными с Samsung Pay.
6. Клиент перенаправляется на страницу Samsung Pay.
7. Клиент вводит свой логин.
   
8. Приложение на мобильном устройстве пользователя запрашивает аутентификационные данные.
9. Клиент в своем устройстве проходит аутентификацию.
10. Платежный шлюз обменивается с системой Samsung Pay платежными данными.
11. Клиент перенаправляется на страницу результата оплаты.

Оплата с веб-страницы на стороне мерчанта

Оплата с платежной страницы на стороне мерчанта

1. Клиент формирует заказ на сайте продавца.
2. Продавец направляет в платежный шлюз запрос регистрации заказа.
   • Одностадийная оплата;
   • Двухстадийная оплата.
3. Платежный шлюз регистрирует заказ, в ответе отправляет идентификатор созданного заказа.
4. Магазин перенаправляет клиента на платежную страницу мерчанта.
5. Браузер клиента открывает платежную страницу мерчанта.
6. Клиент получает платежную форму.
7. Клиент выбирает оплату через Samsung Pay (Web).
8. Продавец отправляет в платежный шлюз запрос оплаты через Samsung Pay.
9. Платежный шлюз обменивается данными с Samsung Pay.
10. Платежный шлюз отправляет ответ на запрос оплаты через Samsung Pay.
11. Платежная форма перенаправляет клиента на страницу Samsung Pay. При этом используется JavaScript-сценарий, в котором вызывается функция connect. В этой функции нужно передать данные из ответа на запрос оплаты через Samsung Pay.
    
12. Клиенту отображается форма для ввода идентификатора.
13. Клиент вводит идентификатор и подтверждает необходимость связывания устройства.
14. Samsung Pay запрашивает аутентификацию клиента.
15. Samsung Pay отправляет оповещение на мобильное устройство клиента для выбора карты оплаты и подтверждения оплаты.
16. Клиент подтверждает оплату.
17. Samsung Pay обменивается данным с платежным шлюзом.
18. Платежный шлюз направляет результат платежа на платежную страницу.
19. Платежная страница отображает результат клиенту.