App

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

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

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

Production url: https://pay.concord.ua/api/apple/validate

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

Параметр	Опис	Тип	Значення
operation	Тип операції	String	Purchase
merchant_id	ID мерчанта	String
amount	Сума операції. Приклад: 500.00	Float
signature	З метою підтвердження валідності даних має бути згенерований і переданий у запиті HMAC_MD5 контрольний підпис з використанням SecretKey мерчанта.	String
	Рядок, що підлягає HMAC_MD5, генерується шляхом конкатенації параметрів 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://pay.concord.ua/api/apple/payment

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

Параметр	Опис	Тип
order_key	Ідентифікатор замовлення в платіжній системі	String
apple_pay_payment_data	Дані платіжного токену ApplePay, закодовані в base64	String

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

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

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