ApplePayApp

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

Щоб зробити покупку за допомогою Apple Pay із додатку, необхідно спочатку надіслати запит Валідація мерчанта та створення заказу, а потім надіслати запит Підтвердження платежу Apple Pay.

Валідація мерчанта та створення заказу (api/apple/validate)

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

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

Параметр	Опис	Тип	Значення
operation	Тип операції	String	Purchase
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

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

Параметр	Опис	Тип
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	Дані платіжного токену ApplePay, закодовані в base64	String
apple_pay_payment_data_decrypted	Параметр передається замість apple_pay_payment_data, якщо використовується оплата з розшифрованим токеном. Дані платіжного токену ApplePay, закодовані в base64.	String

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

Параметр	Опис	Тип	Значення
transactionStatus	Статус операції	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"
  }
}