ApplePayWeb

Операція купівлі через Apple Pay

Для інтеграції кнопки Apple Pay на платіжну сторінку інтернет магазину необхідно реалізувати метод ApplePaySession.canMakePaymentsWithActiveCard. Метод визначає, чи підтримує цей пристрій оплату за допомогою Apple Pay.

Якщо так - необхідно відобразити кнопку "Купити за допомогою Apple Pay".

Далі необхідно створити об'єкт ApplePaySession з параметрами покупки:

  countryCode: 'UA',
  currencyCode: 'UAH',
  supportedNetworks: ['visa', 'masterCard'],
  merchantCapabilities: ['supports3DS'],
  total: { label: 'Your Merchant Name', amount: '10.00' },

Опис полів можна подивитися в документації Apple Pay on Web.

На подію onvalidatemerchant необхідно призначити обробник, в якому буде викликатися API "api / apple / validate". Опис методу буде нижче.

На подію onpaymentauthorized необхідно призначити обробник, який буде викликати API "api / apple / payment".

Після підтвердження платежу в onpaymentauthorized необхідно викликати метод ApplePaySession.completePayment.

Документацію по ApplePaySession можна знайти на оф.сайті Apple.

Валідація мерчанта Apple Pay (api/apple/validate)

Production url: https://****.procard-ltd.com/api/apple/validate

POST-параметри:

Параметр	Опис	Тип	Значення
operation	Тип операції	String	Purchase
apple_validation_url	Цей параметр приходить в подію onvalidatemerchant, event.validationURL session.onvalidatemerchant = (event) => {   console.log(event.validationURL); }	String
merchant_id	ID мерчанта	String
amount	Сума операції. Приклад: 500.00	Float
signature	З метою підтвердження валідності даних має бути згенерований і переданий у запиті HMAC_SHA512 контрольний підпис з використанням SecretKey мерчанта.	String
	Рядок, що підлягає HMAC_SHA512, генерується шляхом конкатенації параметрів merchant_id, order_id, amount, currency_iso, description розділених ";" (крапка з комою) в кодуванні UTF-8.
	Порядок параметрів під час конкатенації важливий!
order_id	Унікальний номер операції на стороні мерчанта. Якщо операція дублюється - мерчант отримує помилку.	String
currency_iso	Валюта платежу	String	UAH
description	Призначення платежу. Виводиться на платіжній сторінці, при введенні платіжних реквізитів. Відображається в виписці за рахунком і реєстрах	String
add_params	Масив з додатковими параметрами. Розширені можливості пошуку потім повертаються мерчанту в callback виклику	Array
callback_url	URL, на який прийде інформація про результат виконання платежу	String

У відповідь надходять такі параметри:

Параметр	Опис	Тип
apple_validate_data	Дані, які необхідно передати в метод session.completeMerchantValidation	string
order_key	Ідентифікатор замовлення в платіжній системі	string
code	Код відповіді (0 - успіх)	integer
message	Розшифровка коду відповіді	string

Підтвердження платежу Apple Pay (api/apple/payment)

Production url: https://****.procard-ltd.com/api/apple/payment

Система сама визначає, яким шляхом іде автентифікація з 3DS або без залежно від даних отриманих від Apple.

POST-параметри:

Параметр	Опис	Тип
order_key	Ідентифікатор замовлення в платіжній системі	string
apple_pay_payment_data	Дані закодовані в base64, отримані в новій події onpaymentauthorized в параметрі event.payment.	string
	Приклад: session.onpaymentauthorized = (event) => {   console.log(event.payment); }
apple_pay_payment_data_decrypted	Параметр передається замість apple_pay_payment_data, якщо використовується оплата з розшифрованим токеном. Дані закодовані в base64, отримані в новій події onpaymentauthorized в параметрі event.payment.	string

У відповідь приходить:

Параметр	Опис	Тип	Значення
transactionStatus	Cтатус операції	String	Approved - Успішно Declined - Відмова
reason	Текстова причина відмови	String
reasonCode	Код помилки при відмові	String

Після виклику цього методу приходить callback в backend мерчанта

Приклад запиту на оплату з розшифрованим токеном:

{
  "order_key": "9910ae2538be76b828f63a08f14ddf4a267d5148713cb2bb2742848fd622cfd266d86cab7f44b",
  "apple_pay_payment_data_decrypted": "ewoiYXBwbGljYXRpb25QcmltYXJ5QWNjb3VudE51bWJlciI6ICI0MDEyMDAwMDAwMDAzMTE5IiwKImFwcGxpY2F0aW9uRXhwaXJhdGlvbkRhdGUiOiAiMjgxMTMwIiwKImN1cnJlbmN5Q29kZSI6ICI5ODAiLAoidHJhbnNhY3Rpb25BbW91bnQiOiAxMDAwMCwKImRldmljZU1hbnVmYWN0dXJlcklkZW50aWZpZXIiOiAiMDQwMDEwMDMwMjczIiwKInBheW1lbnREYXRhVHlwZSI6ICIzRFNlY3VyZSIsCiJwYXltZW50RGF0YSI6ewoib25saW5lUGF5bWVudENyeXB0b2dyYW0iOiIxMjMiLAoiZWNpSW5kaWNhdG9yIjoiNSIKfQp9Cg=="
}

Структура розшифрованого токена:

Параметр	Описание	Тип
applicationPrimaryAccountNumber	Токенізований номер картки	String
applicationExpirationDate	Дата закінчення терміну дії картки (формат YYMMDD)	String
currencyCode	Валюта платежу	String
transactionAmount	Сума транзакції. Приклад 500.00	Float
deviceManufacturerIdentifier	Унікальний ідентифікатор виробника пристрою	String
paymentDataType	Тип платіжних даних	String
paymentData
onlinePaymentCryptogram	Криптограма для безпечних онлайн-транзакцій	String
eciIndicator	Індикатор електронної торгівлі, показує рівень безпеки транзакції	String

Приклад розшифрованого токена:

{
  "applicationPrimaryAccountNumber": "4012000000003119",
  "applicationExpirationDate": "281130",
  "currencyCode": "980",
  "transactionAmount": 10000,
  "deviceManufacturerIdentifier": "040010030273",
  "paymentDataType": "3DSecure",
  "paymentData": {
    "onlinePaymentCryptogram": "123",
    "eciIndicator": "5"
  }
}