Apple Pay позволяет принимать оплату напрямую с iPhone, iPad, Mac и Apple Watch, используя встроенную биометрию или пароль устройства. Для интернет-магазина это сокращает время оформления заказа и снижает процент отказов при оплате. Чтобы интегрировать систему, необходимо использовать Apple Pay on the Web, доступный через Apple Developer Program.
Для начала требуется активная учетная запись разработчика Apple и домен, подтвержденный в Apple Developer. Без привязки домена система не даст возможности принимать платежи. Подтверждение выполняется путем загрузки файла проверки в корневой каталог сайта и его последующей валидации через консоль разработчика.
Далее подключается платежный провайдер, поддерживающий Apple Pay, например Stripe, Adyen или CloudPayments. Эти сервисы предоставляют готовые SDK и API для приема транзакций. Важно выбрать провайдера, который работает с валютой и юрисдикцией бизнеса, так как список поддерживаемых стран ограничен.
После настройки необходимо сгенерировать Merchant ID и связанный сертификат в Apple Developer Console. Эти данные используются для шифрования платежных токенов и должны быть установлены на сервере. Без корректно созданного сертификата транзакции будут отклоняться.
Тестирование проходит в среде Sandbox Apple Pay. Для этого создаются специальные тестовые карты в Wallet, позволяющие проверить весь процесс от выбора товара до получения статуса платежа. Только после успешного тестирования можно переходить к рабочей среде и принимать реальные транзакции.
Проверка требований Apple для интеграции
Перед добавлением Apple Pay на сайт необходимо убедиться, что ресурс соответствует техническим и юридическим условиям Apple. В первую очередь требуется действующий аккаунт в Apple Developer Program, оформленный на организацию или индивидуального предпринимателя. Без этого доступа невозможно получить необходимые ключи и идентификаторы.
Сайт должен работать по защищенному протоколу HTTPS с корректным SSL-сертификатом. Apple проверяет наличие шифрования, так как платежные данные передаются только через защищенные соединения. Использование самоподписанных сертификатов не допускается.
Поддержка домена обязательна через регистрацию его в Apple Developer Console. Для подтверждения владения доменом нужно разместить специальный файл в корневом каталоге сайта и пройти верификацию. Без этого платежные кнопки не будут активированы.
Продавец обязан использовать платежный шлюз или процессинг, поддерживающий Apple Pay. Список поддерживаемых партнеров публикуется Apple и регулярно обновляется. При выборе провайдера необходимо убедиться, что он предоставляет API для приема платежей с Apple Pay и соответствует требованиям PCI DSS.
Требуется наличие действующего юридического лица с поддержкой расчетов в тех странах, где планируется использовать Apple Pay. Apple не активирует платежи для неподтвержденных компаний или сайтов без прозрачной юридической информации.
Регистрация в Apple Developer Program
Для интеграции Apple Pay на сайт необходимо иметь активную учетную запись в Apple Developer Program. Эта программа предоставляет доступ к сертификатам, ключам и настройкам, без которых оплата не будет работать.
Регистрация осуществляется на сайте developer.apple.com. Требуется Apple ID, который будет использоваться для входа. Перед началом стоит подготовить актуальные данные паспорта или документа, подтверждающего личность, если регистрация проводится как физическое лицо. Для компаний дополнительно понадобится D-U-N-S номер, который можно получить бесплатно через Dun & Bradstreet.
Стоимость участия составляет 99 долларов США в год. Оплата производится банковской картой, привязанной к Apple ID. После оплаты аккаунт активируется в течение нескольких часов или дней, в зависимости от проверки документов.
При регистрации юридического лица Apple связывается с организацией по указанным контактам, чтобы подтвердить полномочия. Важно использовать официальную электронную почту компании, а не личный адрес.
После активации учетной записи в Apple Developer Program становится доступен раздел Certificates, Identifiers & Profiles, где создаются необходимые ключи для подключения Apple Pay.
Создание идентификатора продавца и домена
Для работы Apple Pay на сайте необходимо зарегистрировать уникальный Merchant ID и привязать к нему домен. Merchant ID используется для идентификации продавца при каждой транзакции и создается один раз в учетной записи Apple Developer.
Войдите в Apple Developer Account и перейдите в раздел Certificates, Identifiers & Profiles. В подразделе Identifiers выберите пункт Merchant IDs и создайте новый идентификатор. Укажите читаемое имя для удобства и уникальный идентификатор в формате merchant.example. После сохранения он появится в списке доступных идентификаторов.
Следующий шаг – добавление домена, с которого будут отправляться платежные запросы. В разделе Merchant Domains нажмите «Add Domain» и введите имя вашего сайта в формате example.com. Apple требует подтверждения права на домен: для этого необходимо загрузить проверочный файл, который будет предоставлен в интерфейсе, и разместить его по адресу https://example.com/.well-known/apple-developer-merchantid-domain-association.
После загрузки файла выполните проверку в консоли Apple Developer. Если файл доступен по указанному пути, домен будет подтвержден и добавлен к вашему Merchant ID. Только после этого возможна корректная интеграция Apple Pay на сайте.
Настройка сертификата Apple Pay
Для работы с Apple Pay требуется специальный платежный сертификат, который связывает домен продавца с системой Apple. Его создание и настройка выполняется через аккаунт в Apple Developer.
Войдите в раздел Certificates, Identifiers & Profiles и выберите пункт Merchant IDs. В списке найдите идентификатор продавца, созданный ранее, и откройте его настройки. В блоке Apple Pay Payment Processing Certificate нажмите кнопку «Create Certificate».
Перед загрузкой необходимо сформировать CSR-файл (Certificate Signing Request) на сервере или локальной машине. Для этого используется утилита Keychain Access на macOS или OpenSSL на других системах. Важно указать корректный Common Name и сохранить закрытый ключ в защищённом месте.
Загрузите полученный CSR в интерфейсе Apple Developer. После обработки появится готовый сертификат в формате .cer, который нужно скачать и установить. Его следует импортировать на сервер в связке с ранее созданным закрытым ключом, получив итоговый .pem-файл.
Готовый сертификат используется платежным шлюзом или напрямую сайтом при шифровании транзакций Apple Pay. Рекомендуется настроить автоматическое обновление сертификата, так как срок его действия ограничен одним годом.
Интеграция Apple Pay через JavaScript API
Для подключения Apple Pay на сайт необходимо использовать ApplePaySession, доступный в браузере Safari. Перед началом работы убедитесь, что домен прошёл проверку в Apple Developer и корректно настроены сертификаты.
Основные шаги интеграции:
- Проверить поддержку Apple Pay в браузере с помощью
window.ApplePaySession. - Создать новый объект
ApplePaySession, указав версию API и объектpaymentRequest. - Определить обязательные параметры
paymentRequest:countryCode– двухбуквенный код страны, напримерRU.currencyCode– код валюты, напримерRUB.merchantCapabilities– поддерживаемые методы (например,["supports3DS"]).supportedNetworks– список платёжных систем (["visa", "masterCard", "mir"]).total– объект с информацией о сумме и названии продавца.
- Обработать события сессии:
onvalidatemerchant– запрос к вашему серверу для прохождения валидации домена через Apple.onpaymentauthorized– обработка платёжных данных и передача токена на сервер для завершения транзакции.oncancel– действия при отмене пользователем.
- Вызвать
session.begin()для отображения платёжного окна.
Все чувствительные данные обрабатываются на стороне сервера. Клиентская часть отвечает только за отображение интерфейса и передачу зашифрованного токена. Для работы с токеном используйте платежный шлюз или прямую интеграцию с банком.
Тестирование платежей в песочнице
Для проверки работы Apple Pay на сайте необходимо использовать среду тестирования – песочницу Apple. Она позволяет имитировать реальные транзакции без списания средств с банковских карт.
Создайте тестовый аккаунт Apple ID в разделе Apple Developer. Используйте его для авторизации на устройстве, на котором будете проводить тесты.
Включите тестовые карты в Wallet через Sandbox, чтобы проверить прохождение платежей и корректное отображение интерфейса Apple Pay на вашем сайте.
Для проверки платежных сценариев используйте тестовые номера карт, предоставленные Apple. Они позволяют проверять успешные и неуспешные транзакции, отмены и ошибки сети.
Проверяйте обработку событий на стороне сервера: авторизацию платежа, подтверждение транзакции и возврат статуса пользователю. Используйте логирование всех этапов для диагностики проблем.
Регулярно обновляйте сертификаты и ключи, используемые в песочнице, чтобы избежать сбоев при эмуляции платежей. После успешного тестирования переходите к подключению Apple Pay в рабочей среде.
Публикация и запуск Apple Pay на сайте
После завершения интеграции и тестирования в песочнице необходимо загрузить актуальный код на рабочий сервер. Убедитесь, что домен зарегистрирован в Apple Developer и сертификаты действительны.
На сайте должны быть подключены JavaScript API и валидный идентификатор продавца. Проверьте корректность JSON-объекта платежа и параметры merchantCapabilities, countryCode и currencyCode.
Перед запуском активируйте функцию проверки доступности Apple Pay на всех поддерживаемых устройствах, используя метод ApplePaySession.canMakePayments(). Это позволит скрывать кнопку Apple Pay для неподдерживаемых устройств.
После публикации выполните тестовую покупку с использованием реальной карты в режиме Production. Проверьте успешное создание токена, обработку платежа на сервере и корректное отображение статусов заказа для пользователя.
Следите за логами ошибок и уведомлениями от Payment Processing Provider. Любые сбои валидации или токенизации должны быть устранены до полноценного запуска на всех страницах, где доступна оплата через Apple Pay.
Вопрос-ответ:
Какие требования нужно выполнить для подключения Apple Pay на сайте?
Для интеграции Apple Pay требуется наличие учетной записи Apple Developer, действующего сертификата для веб-платежей и уникального идентификатора продавца. Также нужно зарегистрировать домен сайта в Apple Developer и убедиться, что сайт работает через HTTPS, так как платежи не поддерживаются на небезопасных соединениях.
Как проходит процесс интеграции Apple Pay через JavaScript API?
Интеграция через JavaScript API включает подключение скрипта Apple Pay, настройку объекта ApplePaySession с информацией о товарах и сумме платежа, проверку доступности Apple Pay у пользователя, а также обработку событий успешной оплаты и ошибок. На серверной стороне необходимо подтвердить платеж и обработать транзакцию с помощью выбранного платежного провайдера.
Можно ли тестировать Apple Pay перед запуском на сайте?
Да, Apple предоставляет тестовую среду — песочницу. В ней можно создавать тестовые карты, имитировать транзакции и проверять корректность работы всех сценариев платежа. Песочница позволяет выявить ошибки в интеграции до запуска на реальных пользователях, включая проверки доступности Apple Pay, успешной оплаты и обработки отказов.
Какие ошибки чаще всего возникают при публикации Apple Pay на сайте и как их исправить?
Частые ошибки включают несоответствие домена в сертификате, некорректную конфигурацию идентификатора продавца, отсутствие HTTPS или ошибки в JavaScript API. Исправление включает проверку правильности доменного файла, обновление сертификата, исправление кода сессий ApplePaySession и повторную проверку платежей в песочнице перед публичным запуском.
