Apple Pay

Введение

Перед тем, как принимать платежи с помощью Applу Pay, выполните действия, представленные в разделах ниже. После выполнения указанных действий вы можете приступать к доработке своего мобильного приложения для взаимодействия с Apple Pay (описание технических подробностей таких доработок находится за рамками настоящего документа, подробнее см. документацию Apple 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. В секции Сертификаты идентификации мерчантов нажмите Добавить ключ.
   Отобразится следующее окно.
   
4. Заполните поля:
   • Apple ID - Укажите Merchant Apple ID.
   • Пароль - Введите пароль, защищающий содержимое файла PKCS12.
   • Домен по умолчанию - введите домен вашего интернет-магазина.
5. Перетащите файл ключевой пары в предназначенную для этого область.
   Он отобразится в списке.
   
6. Нажмите Создать. Импортированный сертификат отобразится в списке Сертификаты идентификации мерчантов.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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сылки на справочную информацию

Google Pay

Введение

Существует несколько вариантов реализации Google Pay™. Эти варианты поддерживают методы аутентификации CRYPTOGRAM_3DS и PAN_ONLY.

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

Оплата в мобильном приложении

1. Клиент выбирает оплату через Google Pay.
2. Приложение запрашивает Google Pay информацию о маскированных карточных данных.
3. Google Pay возвращает в приложение маскированные карточные данные.
4. Приложение отображает клиенту маскированные данные карты, добавленной в Google Pay.
5. Клиент подтверждает оплату с помощью добавленной в Google Pay карты.
6. Приложение запрашивает Google Pay зашифрованные карточные данные.
7. Google Pay шифрует данные, используя открытый ключ мерчанта.
8. Google Pay возвращает в приложение зашифрованные данные о платеже.
9. Приложение отправляет запрос на оплату Google Pay платежному шлюзу, запрос содержит токен, полученный от Google Pay.
10. Платежный шлюз расшифровывает полученный токен и производит оплату.
11. Платежный шлюз возвращает результат оплаты в приложение.
12. Приложение отображает результат оплаты клиенту.

Оплата на платежной странице, которая расположена на стороне интернет-магазина

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

Оплата на платежной странице, которая расположена на стороне платежного шлюза

Если платежная страница расположена на стороне Google Pay, платеж происходит по следующей схеме.

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

Сценарий оплаты с перенаправлением пользователя в ACS

Если пользователь выбрал вариант оплаты через Google Pay нетокенизированной картой, в ответе на запрос оплаты в платежный шлюз вернутся данные для перенаправления пользователя на ACS эмитента.

1. Клиент выбирает способ оплаты Google Pay.
2. Приложение запрашивает Google Pay информацию о маскированных карточных данных.
3. Google Pay возвращает маскированные карточные данные.
4. Приложение отображает клиенту маскированные данные карты, добавленной в Google Pay.
5. Клиент подтверждает оплату с помощью добавленной в Google Pay карты.
6. Приложение запрашивает Google Pay зашифрованные карточные данные.
7. Google шифрует данные, используя открытый ключ.
8. Google Pay возвращает в приложение зашифрованные данные о платеже.
9. Приложение отправляет запрос на оплату Google Pay платежному шлюзу, запрос содержит токен, полученный от Google Pay.
10. Платежный шлюз расшифровывает полученный токен и проверяет карту, токенизирована она или нет. Если нет, проверяет на вовлеченность в 3-D  Secure.
11. При условии, что карта вовлечена в 3-D Secure, платежный шлюз отправляет ответ на запрос на оплату, в котором содержится ссылка перенаправления на сервер ACS (acsUrl) и значение запроса на аутентификацию PaReq.
12. Продавец перенаправляет пользователя на сайт ACS. Для перенаправления на ACS, продавец со своей стороны должен отправить клиента по адресу, указанному в параметре acsUrl  с телом запроса MD=mdorder&PaReq=pareq&TermUrl=redirect, где:
    • mdorder - уникальный номер заказа в системе платежного шлюза,
    • pareq - параметр из ответа на запрос оплаты,
    • redirect - параметр из ответа на запрос оплаты (адрес возврата с ACS).
13. Пользователь переходит на сайт ACS и аутентифицируется.
14. ACS проверяет данные аутентификации.
15. ACS перенаправляет результат аутентификации в платежный шлюз (PaRes)
16. Платежный шлюз проводит платеж.
17. Платежный шлюз направляет результат платежа продавцу.
18. Продавец запрашивает статус платежа.
19. Платежный шлюз возвращает результат оплаты.
20. Продавец передает результат клиенту.

Оплата Google Pay с использованием 3DS 2.0.

При оплате Google Pay с помощью метода /google/payment.do или google/paymentDirect.do можно использовать аутентификацию клиента по протоколу 3DS 2.0. В этом случае для каждой транзакции вам необходимо отправить в платёжный шлюз запрос на оплату два раза. Отправка первого запроса инициирует процедуру аутентификации по протоколу 3DS 2.0, а отправка второго — продолжает процедуру с данными, полученным от сервера 3DS (дополнительного компонента, который взаимодействует с платежными системами и ACS).

Если клиент после аутентификации перенаправляется на страницу магазина, необходимо завершить платёж, отправив запрос finish3dsVer2Payment.do.

Схема 3DS2 с использованием google/paymentDirect.do.

Ниже приведена схема оплаты с помощью запроса google/paymentDirect.do (расшифровка токена на вашей стороне) с использованием 3DS 2.0.

1. Клиент в мобильном приложении или на сайте выбирает оплату с помощью Google Pay.
2. Приложение запрашивает в Google Pay список карт клиента.
3. Google Pay передаёт в приложение список маскированных карт клиента.
4. Клиент выбирает карту, которой будет расплачиваться. Эти данные отправляются в Google Pay.
5. Google Pay передаёт в приложение зашифрованный paymentToken.
6. Мерчант расшифровывает paymentToken.
7. Оплата заказа - этап1. Мерчант передаёт расшифрованные данные paymentToken в платёжный шлюз, отправляя запрос google/paymentDirect.do.
8. Платёжный шлюз проверяет на сервере 3DS возможность проведения аутентификации клиента по протоколу 2.0 и отправляет ответ. В ответе, в том числе, возвращаются следующие параметры:
   • is3DSVer2 - флаг возможности проведения аутентификации 3DSv2 (true/false),
   • threeDSServerTransId - идентификатор транзакции, присвоенный сервером 3DS,
   • threeDSMethodURLServer - адрес сервера 3DS для сбора данных о браузере,
   • threeDSMethodURL - (необязательно) адрес сервера ACS для сбора данных о браузере,
   • threeDSMethodDataPacked - (необязательно) данные для сбора данных о браузере на ACS.
9. Мерчант в отдельном iframe методом POST вызывает threeDSMethodURLServer, используя значение, полученное из ответа на запрос оплаты заказа. Это позволяет серверу 3DS собрать данные о браузере клиента.
10. (Необязательный шаг) Если в ответе на запрос оплаты заказа пришли параметры threeDSMethodURL и threeDSMethodDataPacked, то мерчант в отдельном iframe методом POST вызывает threeDSMethodURL. В этом методе необходимо передать значение, полученное из параметра threeDSMethodDataPacked, полученного в ответе на запрос оплаты заказа. При этом нужно его передать в параметре, который называется threeDSMethodData. Это позволяет ACS собрать данные о браузере клиента.
11. Оплата заказа - этап 2. Мерчант повторно отправляет запрос google/paymentDirect.do, чтобы завершить оплату заказа (или осуществить перевод денежных средств). При этом необходимо передать параметр threeDSServerTransId - идентификатор транзакции, который был создан сервером 3DS и возвращён на шаге 8. Кроме того, для переадресации клиента на страницу магазина после проведения оплаты заказа можно передать ссылку переадресации в параметре threeDSVer2FinishUrl.
12. Платежный шлюз взаимодействует с 3DS сервером и ACS, чтобы выяснить, требуется ли клиенту проходить аутентификацию на ACS, и отправляет ответ на запрос оплаты. Если клиенту требуется проходить аутентификацию на ACS, в ответе возвращается acsUrl – URL для перенаправления на ACS, а также packedCReq – упакованные данные для challenge request. Если не требуется – возвращается ответ об успешном завершении оплаты.

13. Если клиенту не требуется проходить аутентификацию на ACS, переходите на шаг 19.

    Если клиенту требуется проходить аутентификацию на ACS, с платежной страницы происходит перенаправление на acsUrl с параметром creq=packedCReq, полученным на шаге 12.

14. ACS направляет клиенту HTML-форму для прохождения проверки подлинности.

15. Клиент проходит проверку подлинности

16. ACS перенаправляет клиента на страницу магазина.

17. Для завершения транзакции мерчант отправляет в платежный шлюз запрос finish3dsVer2Payment.do, передавая параметр threeDSServerTransId - идентификатор транзакции, который был создан сервером 3DS и возвращён на шаге 8.

18. Платёжный шлюз отправляет мерчанту ответ на сделанный запрос.

19. Мерчант делает расширенный запрос статуса заказа getOrderStatusExtended.do в платёжный шлюз, чтобы выяснить состояние заказа.

20. Платёжный шлюз отправляет ответ на сделанный запрос.

21. Мерчант отображает клиенту страницу с результатом.

Схема 3DS2 с использованием google/payment.do.

Ниже приведена схема оплаты с помощью запроса /google/payment.do (расшифровка токена на стороне Платежного шлюза) с использованием 3DS 2.0.

1. Клиент в мобильном приложении или на сайте выбирает оплату с помощью Google Pay.
2. Приложение запрашивает в Google Pay маскированные данные карты клиента.
3. Google Pay передаёт в приложение маскированные данные карты клиента.
4. Мерчант отображает клиенту данные карты.
5. Клиент подтверждает оплату.
6. Мерчант запрашивает у Google Pay зашифрованные данные карты.
7. Google Pay шифрует данные карты.
8. Google Pay возвращает мерчанту зашифрованные данные карты (токен).
9. Оплата заказа - этап1. Продавец передаёт расшифрованные данные paymentToken в платёжный шлюз, отправляя запрос /google/payment.do.
10. Платежный шлюз расшифровывает токен.
11. Платёжный шлюз проверяет на сервере 3DS возможность проведения аутентификации клиента по протоколу 2.0 и отправляет ответ. В ответе, в том числе, возвращаются следующие параметры:
    • is3DSVer2 - флаг возможности проведения аутентификации 3DSv2 (true/false),
    • threeDSServerTransId - идентификатор транзакции, присвоенный сервером 3DS,
    • threeDSMethodURLServer - адрес сервера 3DS для сбора данных о браузере,
    • threeDSMethodURL - (необязательно) адрес сервера ACS для сбора данных о браузере,
    • threeDSMethodDataPacked - (необязательно) данные для сбора данных о браузере на ACS.
12. Мерчант в отдельном iframe методом POST вызывает threeDSMethodURLServer, используя значение, полученное из ответа на запрос оплаты заказа. Это позволяет серверу 3DS собрать данные о браузере клиента.
13. (Необязательный шаг) Если в ответе на запрос оплаты заказа пришли параметры threeDSMethodURL и threeDSMethodDataPacked, то мерчант в отдельном iframe методом POST вызывает threeDSMethodURL. В этом методе необходимо передать значение, полученное из параметра threeDSMethodDataPacked, полученного в ответе на запрос оплаты заказа. При этом нужно его передать в параметре, который называется threeDSMethodData. Это позволяет ACS собрать данные о браузере клиента.
14. Оплата заказа - этап 2. Мерчант повторно отправляет запрос /google/payment.do, чтобы завершить оплату заказа (или осуществить перевод денежных средств). При этом необходимо передать параметр threeDSServerTransId - идентификатор транзакции, который был создан сервером 3DS и возвращён на шаге 11. Кроме того, для переадресации клиента на страницу магазина после проведения оплаты заказа можно передать ссылку переадресации в параметре threeDSVer2FinishUrl.
15. Платежный шлюз взаимодействует с 3DS сервером и ACS, чтобы выяснить, требуется ли клиенту проходить аутентификацию на ACS, и отправляет ответ на запрос оплаты. Если клиенту требуется проходить аутентификацию на ACS, в ответе возвращается acsUrl – URL для перенаправления на ACS, а также packedCReq – упакованные данные для challenge request. Если не требуется – возвращается ответ об успешном завершении оплаты.

16. Если клиенту не требуется проходить аутентификацию на ACS, переходите на шаг 22.

    Если клиенту требуется проходить аутентификацию на ACS, с платежной страницы происходит перенаправление на acsUrl с параметром creq=packedCReq, полученным на шаге 15.

17. ACS направляет клиенту HTML-форму для прохождения проверки подлинности.

18. Клиент проходит проверку подлинности

19. ACS перенаправляет клиента на страницу магазина.

20. Для завершения транзакции мерчант отправляет в платежный шлюз запрос finish3dsVer2Payment.do, передавая параметр threeDSServerTransId - идентификатор транзакции, который был создан сервером 3DS и возвращён на шаге 11.

21. Платёжный шлюз отправляет мерчанту ответ на сделанный запрос.

22. Мерчант делает расширенный запрос статуса заказа getOrderStatusExtended.do в платёжный шлюз, чтобы выяснить состояние заказа.

23. Платёжный шлюз отправляет ответ на сделанный запрос.

24. Мерчант отображает клиенту страницу с результатом.

Требования к платежной странице на стороне продавца

Платежная страница на стороне продавца должна соответствовать следующим требованиям.

• На платежной странице должна быть предусмотрена возможность перенаправления на 3DS в результате вызова метода по оплате, если в расшифрованном токене указан метод оплаты CARD.
• Страница должна содержать платежную кнопку Google Pay.
• На платежной странице должна быть отображена кнопка, позволяющая осуществлять оплату с помощью Google Pay.

paymentsClient.isReadyToPay({allowedPaymentMethods: allowedPaymentMethods})
    .then(function(response) {
      if (response.result) {
        // in this case the button should be displayed
        addGooglePayButton();
      }
    })
    .catch(function(err) {
      // show error in developer console for debugging
      console.error(err);
    });

function addGooglePayButton() {
  var button = document.createElement('button');
  button.className = 'google-pay';
  button.appendChild(document.createTextNode('Google Pay'));
  sbutton.addEventListener('click', onGooglePaymentButtonClicked);
  document.getElementById('container').appendChild(button);
}

• На платежной странице должен быть включен JavaScript Google (подробнее см. документацию Google:
  • https://developers.google.com/pay/api/web/guides/tutorial);
  • https://payments.developers.google.com/js/apis/pay.js.
• На платежной странице для тестового взаимодействия с Google значение свойства environment должно быть TEST (см. пример кода ниже).

var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

• Значение для основной версии страницы должно быть получено от Google после выполнения проверок (подробнее см. документацию Google: https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist)).

• На платежной странице должен быть сформирован объект paymentDataRequest (см. пример кода ниже). Используйте следующие тестовые данные:

  • gateway - bpcpay (или значение, предоставленное при подключении к тестовой площадке)
  • gatewayMerchantId – значение, предоставленное подключении к тестовой площадке

function getGooglePaymentDataConfiguration() {
  return {
    merchantId: '00000000000000000000', //constant for the bank's RBE; for the environment: 'TEST' is not indicated
    transactionInfo = {
        totalPriceStatus: 'FINAL',
        totalPrice: '123.45', //amount in major units
        currencyCode: 'EUR' //ISO 4217
    },
    paymentMethodTokenizationParameters: {
        tokenizationType: 'PAYMENT_GATEWAY',
        parameters: {
            gateway: 'some-bank', //constant for the bank's RBE
            gatewayMerchantId: 'exampleGatewayMerchantId' //merchant identifier in the payment gateway
        }
    },
    allowedPaymentMethods: ['CARD', 'TOKENIZED_CARD'],
    cardRequirements: {
        allowedCardNetworks: ['MASTERCARD', 'VISA']
    }
  };
}

• После нажатия кнопки оплаты посредством Google Pay объект paymentDataRequest должен быть передан в Google (см. пример кода ниже).

var paymentDataRequest = getGooglePaymentDataConfiguration();
paymentsClient.loadPaymentData(paymentDataRequest).then(function(paymentData){
  processPayment(paymentData);
}).catch(function(err){
  // show error in developer console for debugging
  console.error(err);
});

Создание ключевой пары

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

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

Выгрузка публичного ключа

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

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

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

• Изменить Google ID
• Установка запрета на использование сертификата

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

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

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

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

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

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

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

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

Samsung Pay

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

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

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

Создание ключевой пары

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

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

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

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

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

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

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

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

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

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

Заверешение регистрации

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

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

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

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

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

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

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

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

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

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. Платежная страница отображает результат клиенту.