Quick Payment

Available: WeChat Pay and Alipay+

This payment method is available in store, Merchant scans the barcode of customer on WeChat App or Alipay+ App to receive the payment.

a) Present payment code. Customer presents Alipay+ / WeChat payment code to cashier

b) Scan payment code. Cashier scans the payment code

c) Payment successful. Payment complete

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.BarcodePayment Required
time Long timestamp Required
  • Parameter
Parameter Type Description Required
pay_method String offline Required
sub_pay_method String WeChat Pay, Alipay, will be obtained through the API of Get sub_pay_method. If it is empty, YabandPay will determine the payment method. Optional
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
demo String custom field Optional
auth_code String the Payment QR Code scanned from customer's Wallet Required
description String order description Required
notify_url String asynchronous notification url Optional

Signature：

Lexicographical sequence and URL key-value format new string

"amount=0.1&auth_code=134443133735495918&currency=EUR&demo=test&description=YabandPay test&method=v3.BarcodePayment&notify_url=https://www.yabandmedia.com/pay/webhook.php&order_id=2019040865658688&pay_method=offline&sub_pay_method=WeChat Pay&time=1555499083&user=016683"

Use stringA and secret_key to get stringSign

Get Signature：

"be920e48e4cf08832be2a79de580edcbc2c92a44350ff8adaf137e69e4adadc0"

Example Request:

{
    "user": "016683",
    "sign": "be920e48e4cf08832be2a79de580edcbc2c92a44350ff8adaf137e69e4adadc0",
    "method": "v3.BarcodePayment",
    "time": 1555499083,
    "data": {
        "amount": "0.1",
        "auth_code": "134443133735495918",
        "currency": "EUR",
        "demo": "test",
        "description": "YabandPay test",
        "notify_url": "https://www.yabandmedia.com/pay/webhook.php",
        "order_id": "2019040865658688",
        "pay_method": "offline",
        "sub_pay_method": "WeChat Pay"
    }
}

Example Response:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "2019040865658688",
        "trade_id": "511444d0-2d91-5396-9e34-f2900e80d715",
        "amount": "0.10",
        "currency": "EUR",
        "settlement_amount": "0.10",
        "settlement_currency": "EUR",
        "exchange_rate": "1",
        "sub_pay_method": "WeChat Pay",
        "state": "paid"
    },
    "message": ""
}

[!TIP|style:flat]

Payment result processing

  1. When the user does not need password verification, the payment result will be returned synchronously.

  2. When the user enters a password for verification after scanning the QR code, the payment result state=processing will be returned. At this time, the merchant needs to use Query Payment Order to query the payment result every 5 seconds.

  3. If the user cancels the payment or the user fails to pay within 30 seconds, it is recommended that the merchant end the query process and continue to call Cancel Payment Order to cancel the payment order. If the user has actually paid, the system will automatically process the refund.

results matching ""

    No results matching ""