API FONDYВерсия 1.0

Шаг 1: Регистрация Apple Merchant ID

Для начала вам необходимо зарегистрировать Apple Merchant ID. Начните с перехода на страницу с инструкцией по регистрации идентификатора продавца на веб-сайте Apple Developer.

Заполните форму с описанием и идентификатором. Ваше описание предназначено для ваших собственных потребностей и может быть изменено в будущем (мы рекомендуем использовать название вашего мобильного приложения). Идентификатор должен быть уникальным (во всех приложениях Apple, а не только в вашем) и не может быть изменен позже (хотя вы всегда можете создать другое). Мы рекомендуем использовать merchant.fondy.eu.{{Your_app_name}}. Сохраните это значение для последующего использования при разработке приложения.

Детальная инструкция:

1.1 Перейдите в Dashboard вашего аккаунта в Apple Developer https://developer.apple.com/account/#

1.2 Войдите в меню Certificates, Identifiers & Profiles

1.3 В меню Identifiers нажите + для создания Merchant ID: https://developer.apple.com/account/resources/identifiers/add/bundleId

1.4 Заполните Description (на ваш выбор) и Identifier (merchant.fondy.eu.{{Your_app_name}}.):

self.api = [PSCloudipspApi apiWithMerchant:1396424 andCloudipspView:self.webView];

3.4 в интеграции SDK укажите merchant_id полученный при регистрации в Fondy Мерчант-Портале в конструкторе

this.api = new Cloudipsp(<ваш Fondy merchant_id>, this.cloudipspWebView);

ссылка на строку в github:

https://github.com/cloudipsp/react-native-cloudipsp/blob/273bcf87d20b6650f96fbd5d424c3c224bc788d3/Example/index.js#L39

Прямая интеграция Apple Pay

Для прямой интеграции с Apple Pay API, следуйте инструкции Apple Pay.

1. Сформируйте приватные ключи
   Apple Pay Payment Processing Certificate Private Key:

   openssl genrsa -out merchant.key 2048  

   Apple Pay Merchant Identity Certificate Private Key:

   openssl ecparam -out apple_pay.key -name prime256v1 -genkey 

2. Сформируйте запросы на сертификаты
   Apple Pay Payment Processing Certificate Request:

   openssl req -new -key merchant.key -out merchant.csr

   Apple Pay Merchant Identity Certificate Request:

   openssl req -new -sha256 -key apple_pay.key -nodes -out apple_pay.csr

3. Загрузите CSR файлы в Apple Developer аккаунт и скачайте сертификаты (см. шаг 2.3 )
4. Отобразите на клиенте кнопку Apple Pay проверив предварительно поддержку платежей на устройстве через метод canMakePayments
   Для работы с Apple Pay на стороне клиента можно воспользоваться
   Apple Pay JS SDK для web
   PassKit (Apple Pay and Wallet) для iOS
5. Используйте ApplePayPaymentRequest чтобы создать ApplePaySession и вызвать диалоговое окно с подтверждением оплаты на клиенте
   При показе формы сработает событие onvalidatemerchant. В параметре события onvalidatemerchant приходит поле validationURL. На этот адрес с бекенда нужно отправить данные, подписанные сертификатом Merchant Identity Certificate. Сертификат нужно предварительно сконвертировать в PEM формат:

   openssl pkcs12 -export -out merchant.p12 -inkey merchant.key -in merchant.pem

   Пример PHP 7.2

   <?php
   
   $ch = curl_init();
   $merchantIdentifier = 'merchant.fondy.eu.{{Your_app_name}}'; // Ваш идентификатор мерчанта Apple Pay с шага 1.4
   $domainName = 'доменное имя'; //Доменное имя вашего сайта, с которого выполняется оплата
   $displayName = 'описание вашего сервиса';
   
   $data = [
       'merchantIdentifier' => $merchantIdentifier,
       'domainName' => $domainName,
       'displayName' => $displayName
   ];
   curl_setopt($ch, CURLOPT_URL, $validationURL);
   curl_setopt($ch, CURLOPT_POST, 1);
   curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
   curl_setopt($ch, CURLOPT_CERTINFO, true);
   curl_setopt($ch, CURLOPT_VERBOSE, true);
   curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_2);
   curl_setopt($ch, CURLOPT_SSLCERT, __DIR__ . '/merchant.pem');
   curl_setopt($ch, CURLOPT_SSLKEY, __DIR__ . '/merchant.key');
   curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
   curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
   curl_setopt($ch, CURLOPT_HTTPHEADER, array("Content-Type: application/json"));
   curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
   
   $res = curl_exec($ch);
   
   curl_close($ch);
   echo json_encode($res);
   

6. Завершите сессию на клиенте, вернув полученный JSON в метод completeMerchantValidation
7. Получите критпограмму платежных данных от Apple Pay SDK на клиенте в ответ на завершение сессии и отправьите полученные данные на бэкенд
8. Переотправьте криптограмму на API endpoint FONDY https://pay.fondy.eu/api/3dsecure_step1/ в параметре container (см. спецификации)
   данные в параметре container должны быть в формате BASE64 и иметь такую структуру:

   {
     "token": {
       "paymentData": {
         "data": "1e3kqjVc...HYJkFFBevkjnAO1jjA9oZsg==",
         "signature": "MIAGCSq...AfMDB4b77L6sCICoUo9Lr+0mSvGrn5wKYvB19yOYEAuVwTcxickud0LmIAAAAAAAA",
         "header": {
           "transactionId": "6fb8a4ea40c8a30c2f8...7b80d9d92d060796018e",
           "ephemeralPublicKey": "MFkwEwYHKoZIz.....W56yaUW+kMjaDsvaRpVldv17/mDgP4cK8F0gXmvBaJ3SA==",
           "publicKeyHash": "Yx3yIurI+gR....xH82t/v9uId/8eKM+A="
         },
         "version": "EC_v1"
       },
       "transactionIdentifier": "6FB8A4EA40C8A30....81EFCC255E7B80D9D92D060796018E",
       "paymentMethod": {
         "network": "Visa",
         "type": "debit",
         "displayName": "Visa 1111"
       }
     }
   }
   

   
   

9. Получите финальный ответ от FONDY с деталями платежа
10. Отобразите покупателю результат оплаты