Native Payment


API URL:https://mapi.yabandpay.com/Payments

Method:POST

POST data type:Json

Parameter Type Description Mark
user String the UID of cashier account Required
sign String signature Required
method String v3.CreatePaymentsWechatMiniPay Required
time Long timestamp Required
  • Parameter
Parameter Type Description Mark
order_id String order id from Merchant Required
url_type String Default value is 01. 01: The returned URL will directly redirect to the YabandPay hosted page; 02: The native QR code URL of WeChat. Optional
amount String format in cents: € 24.99 should be 24.99, the min amount is EUR 0.10 or CNY1 Required
currency String ISO 4217, For example EUR, CHF Required
description String der description Required
demo String custom field Optional
timeout String alue 0 means 1440 minutes Optional
notify_url String asynchronous notification url Required
redirect_url String the redirect URL after payment is completed Required Optional

Signature:

Lexicographical sequence and URL key-value format new string

"amount=1&currency=EUR&description=yaband test&method=v3.CreateWechatNativePay&notify_url=https://www.yabandpay.com/notify&order_id=2024821984761654842&redirect_url=https://www.yabandpay.com&time=1568553105&timeout=0&user=h5@yaband.com"

Use stringA and secret_key to get stringSign

Get Signature:

"af5f4a2e6c4442afdfc0f33e330654804d74ab71236e9483c672a8888a0798ea"

Example Request:

{
    "user": "016683",
    "sign": "af5f4a2e6c4442afdfc0f33e330654804d74ab71236e9483c672a8888a0798ea",
    "method": "v3.CreateWechatNativePay",
    "time": 1568553105,
    "data": {
            "url_type": "01",
            "order_id": "2024821984761654842",
            "amount": "1",
            "currency": "EUR",
            "timeout": "0",
            "description": "yaband test",
            "redirect_url": "https://www.yabandpay.com",
            "notify_url": "https://www.yabandpay.com/notify"
    }
}

Example Response:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "2024821984761654842",
        "trade_id": "289c6441-056e-676e-80e6-672651911070",
        "amount": "1.00",
        "currency": "EUR",
        "settlement_amount": "1.00",
        "settlement_currency": "EUR",
        "exchange_rate": "1",
        "url": "https://pay.yabandpay.com/payments/wechat_native_callback/order/Mjg5YzY0NDEtMDU2ZS02NzZlLTgwZTYtNjcyNjUxOTExMDcw",
        "state": "processing"
    },
    "message": ""
}

More Information:

Return results:
  1. On a successful API call, the response will be "status": true.

  2. On a failed API call, the response will be "status": false.

We strongly recommend using both Order Query and Asynchronous Notification simultaneously to synchronize and update payment status, ensuring real-time accuracy of payment information.

Result/Error codes:
Status Code Message
true 200 Success
fales -1000 Internal error
fales -3001 Required field is missing
fales -403 The signature Error
fales -4011 Not support the payment method

results matching ""

    No results matching ""