QR Master Pass

Матеріал з partnerdocs

(Для мерчантів, які мають пряму інтеграцію з MasterPass)

Оплата з гаманця MasterPass із використанням Qr code.

Отримання даних для QR-code


Потрібно створити сесію (для детальної інформації перейдіть за посиланням - Створення сесії). Після цього необхідно створити замовлення (Створення замовлення).

У відповіді в paymentInstrumentsTypes => instrumentType: "QrMasterpass" об'єкт, який містить інформацію для формування QR code. У instrumentvalue буде рядок, з якого потрібно генерувати QR code.


Приклад: paymentInstrumentsTypes => instrumentType: "QrMasterpass"

{
   "instrumentType":"QrMasterpass",
   "commission":0.0,
   "amountMin":1.00,
   "amountMax":14999.00,
   "userPaymentInstruments":[
  	{
     	"instrumentId":8499910,
     	"instrumentType":"QrMasterpass",     	  "instrumentValue":"00020101021252040000530398054034005802UA5909EasyPayUa6004Kiev64190002UK0109EasyPayUa80850017ua.mastercard.www010200020840703434032003434180702054456177041211109354874205020181500017ua.mastercard.www011720191111093548742020499996223030443590603391070410036304AF79",
     	"alias":null,
     	"commission":0.0,
     	"loyaltyCommission":null,
     	"actionsKeys":null,
     	"priorityIndex":0,
     	"additionalParams":{
        	"OrderId":"4825209b-1caa-472e-b530-dc3e8efd541c"
     	}
  	}
   ]
}

Перевірка статусу QR code

Метод повертає інформацію про поточний статус QR code.

GET /api/payment/qrPaymentCheck

Request

headers
'PartnerKey: partnerName' 
'locale: ua'
'AppId: a5806a5f-dbb8-496a-a23f-aab6d2fcbce1'
'PageId: 2ce7dba6-4600-456e-b9c8-f13cacf1c85d'
'Sign: e0v1vIOMyNt2qSmrG5+sjAq8wOhvgDDUEyfVP21mRU4='

queryParams
“orderId”: “string”

Response

headers
----

body
{
  "status": "Generated",
  "transactionId": null,
  "error": null
}
Параметр Характеристика
status

Можливі значення:

  • Generated — QR згенеровано
  • Scanned — QR відскановано
  • PaymentStarted — платіж розпочато
  • PaymentFinished — платіж завершено
  • None — статус відсутній
transactionId

Ідентифікатор платежу в системі EasyPay.


Оплата за QR code

Метод для оплати за QR кодом. Працює тільки з QR кодами, які були отримання від EasyPay.

GET /api/payment/create/qr


Request

headers
'PartnerKey: partnerName' 
'locale: ua'
'AppId: a5806a5f-dbb8-496a-a23f-aab6d2fcbce1'
'PageId: 2ce7dba6-4600-456e-b9c8-f13cacf1c85d'

body
{
  "qrCode": "string",
  "amount": 1,
  "userPaymentInstrument": {
	"instrumentId": 8499910,
	"instrumentType": "QrMasterpass",
                 "alias": "Mycard",
                 "pan": "4102*******4441"
  },
  "resultUrl": "string"
}

Response

headers
----
body
{
  "paymentState": "Confirmed",
  "status": "Done",
  "retrievalReferenceNo": 11111111,
  "error": null
}
Параметр Характеристика
paymentState

Можливі значення:

  • Confirmed
  • Rejected