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¤cy=EUR&description=yaband test&method=v3.CreateWechatNativePay¬ify_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:
On a successful API call, the response will be
"status": true
.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 |