QR Code Payment
Available: all payment methods
[!TIP|style:flat]
This payment method is available in store. Customers scan the QR code of merchants to complete payment.
API URL:https://mapi.yabandpay.com/Payments
Method:POST
POST data type:Json
Parameter | Type | Description | Required |
---|---|---|---|
user | String | the UID of cashier account | Required |
sign | String | signature | Required |
method | String | v3.QRcodePayment | Required |
time | Long | timestamp | Required |
- Parameter
Parameter | Type | Description | Required |
---|---|---|---|
pay_method | String | offline | Required |
sub_pay_method | String | QRcode | Required |
order_id | String | order id from Merchant | Required |
amount | String | format in cents: € 24.99 should be 24.99, the min amount is EUR 0.10 or CNY 1.00 | Required |
currency | String | ISO 4217, For example EUR, CHF | Required |
description | String | order description | Required |
demo | String | custom field | Optional |
timeout | String | value 0 means 1440 minutes | Optional |
redirect_url | String | the redirect URL after payment is completed | Optional |
notify_url | String | asynchronous notification url | Optional |
Signature:
Lexicographical sequence and URL key-value format new string
"amount=0.1¤cy=EUR&demo=test&description=YabandPay test&method=v3.QRcodePayment¬ify_url=https://www.yabandmedia.com/pay/webhook.php&order_id=20180902014018888&pay_method=offline&redirect_url=https://www.yabandmedia.com/pay/redirectpage.php&sub_pay_method=QRcode&time=1555498137&timeout=0&user=016683"
Use stringA and secret_key to get stringSign
Get Signature:
"280369cbddd6b45568a52f27b5becb4564903bcefbc32de26b1636a100eaee0f"
Example Request:
{
"user": "016683",
"sign": "280369cbddd6b45568a52f27b5becb4564903bcefbc32de26b1636a100eaee0f",
"method": "v3.QRcodePayment",
"time": 1555498137,
"data": {
"amount": "0.1",
"currency": "EUR",
"demo": "test",
"description": "YabandPay test",
"notify_url": "https://www.yabandmedia.com/pay/webhook.php",
"order_id": "20180902014018888",
"pay_method": "offline",
"redirect_url": "https://www.yabandmedia.com/pay/redirectpage.php",
"sub_pay_method": "QRcode",
"timeout": "0"
}
}
Example Response:
{
"status": true,
"code": "200",
"data": {
"order_id": "20180902014018888",
"trade_id": "4552eeea-1ae8-1e40-3b4b-802dc2f5686a",
"amount": "0.10",
"currency": "EUR",
"settlement_amount": "0.10",
"settlement_currency": "EUR",
"exchange_rate": "1",
"url": "https://partner.yabandpay.com/payments/selectpay/order/ODlmYmYyMzQtN2U1Yy00ZDI5LTM5NWMtNGI4NzljYjI4MDlj",
"available_payment_methods": "Alipay+, Wechat Pay, iDEAL, UnionPay, QuickPass, Bancontact, Visa, Mastercard, Sofort, Klarna, PayPal, ApplePay, GooglePay, Giropay",
"state": "processing"
},
"message": ""
}
[!TIP|style:flat]
Please display the returned URL (or convert the URL into a QR code) and icons of available payment methods to the user.