Інтеграція 1С-Бітрікс з платіжною системою Apple Pay

Інтеграція 1С-Бітрікс з платіжною системою Apple Pay

Ми часто отримуємо запити на впровадження Apple Pay в інтернет-магазини на 1С-Бітрікс. Apple Pay — не окрема платіжна система, а надбудова над наявним еквайрингом. Без банку-еквайра або агрегатора, що підтримує сервіс, жоден платіж не пройде. Багато розробників недооцінюють серверну частину: Apple вимагає верифікації домену через Merchant Identity Certificate, і без неї кнопка не з'явиться, як би красиво не був написаний JS-код. Більше того, сама сесія платежу вимагає тристороннього рукостискання між браузером користувача, сервером магазину та серверами Apple. Розберемо цей процес детально.

Apple Developer documentation: "Before you can process payments, you must verify that you control the merchant's domain by uploading a domain association file."

Як домен верифікується в Apple Pay?

1. Фронтенд перевіряє доступність: ApplePaySession.canMakePayments() — працює тільки в Safari на Apple-пристроях.
2. При ініціації платежу браузер запитує Payment Session у сервера магазину.
3. Сервер магазину проксіює запит до Apple через Merchant Identity Certificate.
4. Apple верифікує домен → повертає сесійний об'єкт.
5. Користувач підтверджує Face ID/Touch ID → браузер отримує зашифрований токен.
6. Токен передається в банк-еквайр для проведення транзакції.

Кроки 3–4 критичні — без серверного коду жодна кнопка не спрацює.

Чому пряма інтеграція потребує більше часу?

При прямій інтеграції ви самостійно керуєте сертифікатами та сесіями Apple. Це дає повний контроль, але збільшує час розробки в 2-3 рази відносно віджета агрегатора. Віджет (CloudPayments, ЮKassa) бере на себе всю серверну частину — достатньо зареєструвати домен в особистому кабінеті та додати кілька рядків JavaScript. Віджет агрегатора у 3 рази швидше налаштовується, ніж пряма інтеграція.

Як підготувати Merchant ID та сертифікати?

• Обліковий запис Apple Developer Program ($99/рік) — для створення Merchant ID та завантаження сертифікатів.
• Верифікація домену: файл .well-known/apple-developer-merchantid-domain-association в корені сайту.
• Банк-еквайр або агрегатор з підтримкою Apple Pay.
• HTTPS — Apple Pay недоступний без SSL.
• Налаштований 1С-Бітрікс з компонентом оплати sale.order.checkout.

Інтеграція через агрегатор (рекомендований шлях)

Якщо вже використовується CloudPayments або ЮKassa — підключення Apple Pay вмикається через їхній віджет, вся серверна частина з сертифікатами береться агрегатором на себе. Вартість підключення — від 5000 грн, але економія на комісії може сягати 2000 грн на місяць. Пряма інтеграція обійдеться від 15 000 грн, але дає більше гнучкості.

// CloudPayments Widget const cp = new cp.CloudPayments({ publicId: 'pk_XXXXXX' }); // Перевіряємо доступність if (window.ApplePaySession && ApplePaySession.canMakePaymentsWithActiveCard('merchant.ru.shop')) { document.getElementById('apple-pay-btn').style.display = 'block'; } document.getElementById('apple-pay-btn').addEventListener('click', () => { cp.pay('applepay', { description: 'Замовлення #' + orderId, amount: orderAmount, currency: 'RUB', invoiceId: String(orderId), accountId: customerEmail, }, { onSuccess: () => confirmOrderPaid(orderId), onFail: (reason) => showError(reason), }); }); 

Попередньо в особистому кабінеті агрегатора потрібно зареєструвати домен — він автоматично додасть файл верифікації. Це найшвидший шлях: за статистикою, конверсія в оплату збільшується на 10-15% порівняно зі звичайною оплатою карткою. Крім того, сервіс скорочує час оформлення замовлення вдвічі — середня транзакція займає лише 2 секунди. Наша сертифікована команда виконає інтеграцію під ключ за 2-3 дні з гарантією якості.

Серверна валідація домену (пряма інтеграція)

Якщо потрібна реалізація без віджета агрегатора:

// local/api/apple-pay-validate.php $validationUrl = filter_var($_POST['validationUrl'] ?? '', FILTER_VALIDATE_URL); // Дозволяємо тільки домени Apple if (!preg_match('#^https://apple-pay-gateway(-cert)?\.apple\.com#', $validationUrl)) { http_response_code(400); exit; } $ch = curl_init($validationUrl); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode([ 'merchantIdentifier' => 'merchant.identifier', 'domainName' => 'your-domain.com', 'displayName' => 'Your Shop', ]), CURLOPT_SSLCERT => APPLE_PAY_CERT_PATH, CURLOPT_SSLKEY => APPLE_PAY_KEY_PATH, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Content-Type: application/json'], ]); $response = curl_exec($ch); curl_close($ch); header('Content-Type: application/json'); echo $response; 

JS-код на сторінці оплати

const session = new ApplePaySession(3, { countryCode: 'RU', currencyCode: 'RUB', supportedNetworks: ['visa', 'masterCard', 'mir'], merchantCapabilities: ['supports3DS'], total: { label: 'Ваш магазин', amount: String(orderAmount) }, }); session.onvalidatemerchant = async ({ validationURL }) => { const resp = await fetch('/api/apple-pay-validate.php', { method: 'POST', body: new URLSearchParams({ validationUrl: validationURL }), }); session.completeMerchantValidation(await resp.json()); }; session.onpaymentauthorized = async ({ payment }) => { const result = await sendTokenToServer(payment.token); session.completePayment( result.success ? ApplePaySession.STATUS_SUCCESS : ApplePaySession.STATUS_FAILURE ); }; session.begin(); 

Додавання в Бітрікс

Кнопку додаємо в шаблон sale.order.checkout. Показуємо тільки при canMakePayments() === true. Після отримання токена — AJAX до PHP-обробника, який передає токен в банк і викликає $payment->setPaid('Y'). Важливо налаштувати правильні події: після успішної оплати перенаправляти на сторінку замовлення.

Що входить в роботу з інтеграції Apple Pay

• Реєстрація Merchant ID та генерація сертифікатів в Apple Developer (1-2 години).
• Розміщення файлу верифікації домену (10 хвилин).
• Налаштування HTTPS та SSL-сертифіката (від 500 грн).
• Інтеграція з обраним агрегатором або пряма серверна валідація (80% клієнтів обирають агрегатор).
• Реалізація кнопки Apple Pay в шаблоні оплати 1С-Бітрікс (4-6 годин).
• Тестування на реальних пристроях (iPhone, iPad, Mac).
• Документування процесу для підтримки.

Типові помилки при інтеграції

• Неправильний Merchant ID або відкликаний сертифікат → кнопка не з'являється.
• Файл верифікації не завантажено в корінь домену → домен не верифікується.
• Відсутня підтримка 3DS → 30% транзакцій відхиляються.
• Код перевірки canMakePayments викликає збій на 10% старих iOS.

Терміни

Маємо 5+ років досвіду в інтеграції платіжних систем. Наша команда виконає роботу під ключ — пишіть нам для оцінки вашого проекту. Замовте впровадження Apple Pay і підвищте конверсію оплат на 10–15% без зайвих витрат часу. За статистикою, користувачі сервісу витрачають на 20% більше, ніж при звичайній оплаті карткою. Крім того, система Apple Pay у 1.5 рази краще за звичайну оплату за конверсією.

Також рекомендуємо ознайомитися з документацією Apple Pay (оригінал) та Wikipedia.

Вимоги для роботи (замість FAQ)

Для роботи Apple Pay в 1С-Бітрікс потрібні такі компоненти: обліковий запис Apple Developer Program ($99/рік), Merchant ID та сертифікати, HTTPS на сайті, банк-еквайр або агрегатор з підтримкою платіжної системи, файл верифікації домену в корені сайту (.well-known/apple-developer-merchantid-domain-association). Пряма інтеграція без агрегатора можлива, але складніша: знадобиться самостійна серверна валідація домену з використанням Merchant Identity Certificate та обробка токенів на стороні банку. Для перевірки працездатності відкрийте сторінку оплати в Safari на iPhone або Mac — якщо пристрій підтримує Apple Pay і в гаманці є картка, кнопка відобразиться. Якщо кнопка не з'являється, перевірте HTTPS, файл верифікації, Merchant ID, реєстрацію домену в агрегаторі та відсутність блокувань AdBlock. Найшвидший та найнадійніший спосіб — використання віджета агрегатора (CloudPayments, ЮKassa), який бере на себе сертифікати та серверну частину.