Apple Pay

theMAP предоставляет возможность осуществлять списания денежные средства с карты Покупателя с использованием токена Apple Pay вместо реквизитов карты.

Принцип работы

Клиент выбирает вариант оплаты Apple Pay. Используя Apple Pay API, ваша система инициирует создание сессии и отправляет команду на открытие кошелька Apple Pay.
В ответ система Apple Pay отправляет событие onvalidatemerchant, в котором содержится validationURL
Ваша система отправляет запрос на validationURL, подписанный Merchant Identity сертификатом
В случае успешной валидации мерчанта, клиенту отображаются доступные карты для оплаты.
Пользователь выбирает карту и подтверждает оплату с помощью Touch Id или Face ID.
На стороне Apple Pay генерируется токен и передается в событии onpaymentauthorized.
Ваша система готовит данные Apple Pay для отправки в службу theMAP. Значение из параметра paymentData в токене необходимо без каких-либо модификаций закодировать с помощью Base64 и отправить в theMAP в качестве параметра ApplePayToken в методы Block, Pay или storeCard
theMAP возвращает ответ авторизации для вашей системы.
Ваша система возвращает авторизационный ответ в платежное приложение/сайт. Платежное приложение/сайт отображает подтверждение или сообщение об отказе для клиента.

Интеграция

Следуйте инструкциям, которые помогут вам правильно разместить элементы бренда Apple Pay на Web-сайтах и в приложении.

WEB-сайт
Приложение

Руководство интеграции в Web-сайт.
Использование фреймворка Apple Pay JS API.
Все страницы сайта должны работать по схеме HTTPS с поддержкой TLS 1.2

Для реализации оплаты с использованием Apple Pay необходимо:

Зарегистрировать Merchant ID в Apple Developer Account.
В случае использования мобильного приложения - получить одобрение от Apple.
Подтвердить владение доменами.
Создать сертификат Merchant Identity Certificate в партнёрском центре Apple.
Получить от theMAP файл запроса подписи сертификата (CSR).
Используя полученный CSR, создать сертификат Payment Processing Certificate в партнёрском центре Apple.
Предоставить в theMAP созданный Payment Processing Certificate.

Схема получения токенизированного номера карты:

Взаимодействие с theMAP

API theMAP поддерживает передачу и обработку параметра ApplePayToken в методах Block, Pay, storeCard и tokenDecrypt.

Пример запроса на одностадийную оплату Pay:

Key=ApplePayTestTerminal&ApplePayToken=jdk324r23bhkbksd83GJHDyhywxko...&OrderId=ApplePayTestOrder-001&Amount=101

В результате успешного выполнения сценария из примера выше, средства клиента будут авторизованы и списаны с помощью theMAP и Apple Pay. Пример успешного ответа:

{
    "Success": true,
    "OrderId": "ApplePayTestOrder-001",
    "Amount": 101,
    "ErrCode": ""
}

Если вы получили ошибочный ответ, пожалуйста, проверьте корректность закодированного в Base64 токена, корректность его передачи и другие параметры. Если данные корректны, обратитесь к словарю ошибок theMAP

Правила использования Apple Pay

Ознакомьтесь с с этими рекомендациями, чтобы правильно использовать технологию и бренд Apple Pay в мобильных приложениях и на WEB-сайтах.

Через Apple Pay нельзя оплачивать товары/услуги, запрещенные к продаже в интернете
Правила использования бренда Apple Pay
Перед началом работы с Apple Pay необходимо пройти процедуру регистрации и проверки WEB-сайта и/или моб. приложения в Apple.