Інтеграція 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), який бере на себе сертифікати та серверну частину.

Як уникнути типових помилок при підключенні платіжних систем на 1С-Бітрікс

Найчастіша помилка при інтеграції — забути про callback. Покупець оплатив замовлення, гроші списалися, а статус у b_sale_order не оновився: менеджер бачить «Очікування оплати» і починає дзвонити клієнту. Причина — неправильний URL у налаштуваннях шлюзу або обробник, що падає з 500 при нестандартній структурі відповіді. Ми пропонуємо послуги з підключення платіжних систем на 1С-Бітрікс з повним тестуванням усіх сценаріїв: успішна оплата, відмова, тайм-аут, часткове повернення, повторний callback.

Чому callback-сповіщення критичні?

Кожен платіжний шлюз надсилає сповіщення на ваш сервер. Якщо обробник не гарантує ідемпотентність — подвійний виклик призведе до подвійного списання. Ми завжди реалізуємо перевірку за ID сповіщення (external_id) та блокування повторної обробки в \Bitrix\Sale\Order. Також критично налаштувати URL callback в особистому кабінеті агрегатора — /bitrix/tools/sale_ps_result.php для штатного модуля. Якщо використовуєте кастомний обробник, перевіряємо, що він віддає HTTP 200 навіть при помилці параметрів (шлюз не повинен повторювати запит нескінченно). Через некоректний callback втрачається до 30% успішних оплат — покупець платить, але статус не оновлюється, і ви не отримуєте гроші.

use Bitrix\Sale\Order;
use Bitrix\Main\Application;

// Отримуємо дані сповіщення
$data = Application::getInstance()->getContext()->getRequest()->toArray();
// Перевіряємо підпис (залежить від агрегатора)
if (!checkSignature($data, 'SECRET_KEY')) {
    die('FAIL');
}
// Шукаємо замовлення за зовнішнім ID
$order = Order::loadByExternalId((int)$data['order_number']);
if ($order && $order->isPaid() === false) {
    $order->setField('PAYED', 'Y');
    $order->save();
}
echo 'OK';

Як вибрати платіжний агрегатор для 1С-Бітрікс?

Вибір залежить від географії покупців, середнього чека та потреби у розстрочці. Для ринку РФ базовий набір — ЮKassa (усі основні методи, фіскалізація з коробки) та CloudPayments (віджет без редиректу, Apple Pay, Google Pay). Якщо працюєте з великими корпоративними клієнтами — додайте Ощадбанк (SberPay, СБП). Для міжнародних продажів — Stripe або PayPal. Ми часто використовуємо дворівневу схему: основний агрегатор + резервний (автоперемикання при падінні). CloudPayments забезпечує на 15–25% більше успішних оплат за рахунок віджету без редиректу — покупець не йде з сайту.

Які платіжні агрегатори та способи оплати ми використовуємо

ЮKassa

Один договір — всі основні способи: картки Visa/MasterCard/МИР, ЮMoney, SberPay, інтернет-банки, розстрочка. Фіскалізація за 54-ФЗ з коробки (через модуль sale). Штатний обробник /bitrix/modules/sale/handlers/paysystem/yandexpay/ покриває базові сценарії. Для холдування (двостадійна оплата), підписок або спліт-платежів — кастомна інтеграція через API v3. Callback налаштовуємо на /bitrix/tools/sale_ps_result.php, парсимо notification та оновлюємо \Bitrix\Sale\Order через setField('PAYED', 'Y').

CloudPayments

Заточений на конверсію: віджет оплати прямо на сторінці чекауту, без редиректу на зовнішній домен. Покупець не йде з сайту — відсоток відмов на етапі оплати падає. Підтримує рекурентні платежі (токенізація картки через cryptogram), Apple Pay та Google Pay. 3D Secure з інтелектуальною маршрутизацією — запитується лише при високому ризику фроду. Інтеграція з Бітрікс — через REST API CloudPayments та кастомний обробник.

Тинькофф Оплата

API-інтеграція через TinkoffPaymentAPI (готовий модуль або ручна реалізація). QR-код для оплати через додаток, розстрочка «Тинькофф Кредит» — критично для дорогих товарів. Часткові повернення через метод Cancel — без дзвінків у банк, все з адмінки Бітрікс.

Ощадбанк (SberPay та СБП)

SberPay — оплата за push-сповіщенням або QR, СБП — комісія нижча порівняно з картками. На обсязі це відчутна економія. Холдування через API registerPreAuth / deposit. Враховуємо, що для SberPay потрібне підписання окремого договору з банком.

Apple Pay та Google Pay

Оплата в два дотики, без введення даних картки. Підключаються через агрегатор (ЮKassa, CloudPayments, Тинькофф). Важливі нюанси:

• Apple Pay вимагає верифікації домену: файл apple-developer-merchantid-domain-association в /.well-known/. Без нього кнопка не з'явиться.
• Розміщення кнопок строго за гайдлайнами Apple та Google — інакше відмова в рев'ю.
• Фолбек на стандартну форму оплати, якщо пристрій не підтримує безконтактну оплату.

Розстрочка, BNPL та робота з 54-ФЗ

Якщо середній чек великий і конверсія просідає — розстрочка знімає ціновий бар'єр. Ми підключаємо:

• Тинькофф Розстрочка (3–24 місяці)
• Покупай зі Сбером
• Мокка / Долями — BNPL: 4 платежі, 0% для покупця

Інтеграція: віджет з розрахунком щомісячного платежу на картці товару («від суми на місяць»), передача даних замовлення в банк через API, обробка статусів (схвалення, відмова, очікування документів) в обробниках OnSaleStatusOrder.

Фіскалізація за 54-ФЗ — обов'язкова вимога. Штраф за відсутність чека — до значної суми. Відповідно до Федерального закону № 54-ФЗ касовий чек повинен бути надісланий покупцю в електронній формі. Підключаємо АТОЛ Онлайн, Orange Data, Модуль.Каса, Евотер, Штрих-М. Налаштування в Бітрікс — розділ «Каси» в модулі sale:

• Ставка ПДВ, предмет та спосіб розрахунку — помилка в будь-якому полі може призвести до штрафу при перевірці.
• Чеки при передоплаті та частковій оплаті (два чеки: при оплаті та при відвантаженні).
• Чеки повернення при скасуванні через \Bitrix\Sale\Cashbox\Cashbox::addChecks().
• Моніторинг: якщо чек не пішов — алерт менеджеру.

При торгівлі взуттям, одягом, парфумерією обов'язкова передача кодів маркування в чеку. Інтеграція з «Честний ЗНАК», сканування DataMatrix при збірці замовлення, автоматичний вивід з обігу при продажу через \Bitrix\Catalog\Product\Marking.

Супровід платежів: повернення, мультивалютність, безпека

Повернення

Повне та часткове повернення без дзвінків у банк — через API агрегатора (refund / cancel). Чек повернення формується автоматично, оновлюється статус замовлення, перераховується сума, сповіщається покупець. Строки: електронні гаманці та СБП — 1–3 дні, банківська картка — до 30 робочих днів (залежить від банку-емітента).

Мультивалютність

Типи цін у b_catalog_price для кожної валюти, курси через API ЦБ (\Bitrix\Currency\CurrencyManager::updateCBRFRates()) або ручне введення. Конвертація на рівні каталогу — покупець бачить ціни у своїй валюті. Для прийому доларів/євро підключаємо Stripe, PayPal. Враховуємо комісії за конвертацію при розрахунку маржинальності.

Безпека

Дані карток обробляються на стороні сертифікованого шлюзу (PCI DSS) — номер картки ніколи не проходить через ваш сервер. Антифрод на рівні агрегатора. Логування всіх подій у b_sale_order_change для аудиту. Моніторинг аномалій: стрибок транзакцій, нетипова географія — алерт.

Як ми працюємо та які орієнтовні терміни?

1. Аналіз — які способи оплати потрібні, ринки, обсяг транзакцій, поточний агрегатор.
2. Підбір рішень — іноді два агрегатори краще одного: ЮKassa як основний, CloudPayments як резерв — при падінні одного трафік іде на другий.
3. Інтеграція — тестуємо кожен сценарій: успішна оплата, відмова 3DS, тайм-аут шлюзу, подвійний callback, часткове повернення.
4. Фіскалізація — онлайн-каса, перевірка коректності чеків на тестових замовленнях.
5. Моніторинг — алерти при збоях шлюзу, дашборд конверсії на етапі оплати.

Як підібрати оптимальний платіжний агрегатор?

Вибір агрегатора залежить від специфіки бізнесу: обсягу продажів, географії клієнтів, необхідності у розстрочці або рекурентних платежах. Ми допомагаємо проаналізувати ваші потреби та обрати найкраще рішення. Маємо понад 7 років досвіду в інтеграції платіжних систем на Бітрікс, реалізували більше 50 проектів. Замовте консультацію — ми розповімо про плюси та мінуси кожного варіанту.

Що входить в роботу

• Повне налаштування вибраних платіжних систем в 1С-Бітрікс: модулі, обробники, callback, тестування.
• Документація з інтеграції (схема роботи шлюзів, опис обробників, логи).
• Навчання вашого менеджера роботі з платіжними модулями та поверненнями.
• Технічна підтримка на етапі запуску та перші 2 тижні експлуатації.
• Моніторинг — налаштовуємо алерти на помилки та падіння конверсії.

Всі роботи виконуються сертифікованими розробниками 1С-Бітрікс. Гарантуємо працездатність кожного сценарію. Для швидкої оцінки вашого проекту залиште заявку на сайті або зв'яжіться з нами — підберемо оптимальне рішення для вашого бізнесу.