文档中心/API 接口

API REFERENCE

H5支付

POSThttps://mapi.yabandpay.com/Payments
实际接口
API PLAYGROUND · 实际接口

H5支付

POSThttps://mapi.yabandpay.com/Payments
填写凭据后自动签名

请求参数10

先填写必填项

H5支付

pay_method必填stringdata.pay_methodonline
sub_pay_method必填stringdata.sub_pay_methodWeChat Pay
amount必填stringdata.amount金额数字。例如 € 24.99 应该写成24.99,CNY金额>=1,欧元金额>=0.1
currency必填stringdata.currencyE货币代码,ISO 4217,例如EUR,CHF
description必填stringdata.description订单描述
timeout必填stringdata.timeout过期时间单位分钟(0-1440)
notify_url必填stringdata.notify_url支付完成后异步通知地址
ip_address必填stringdata.ip_addressIp地址
可选参数 2
demo可选stringdata.demo自定义字段
redirect_url可选stringdata.redirect_url支付完成后跳转地址

凭据仅在当前页面使用。secret_key 不保存,也不发送给文档服务器。

小贴士

注意:微信默认不支持H5支付,请向YabandPay申请开通后使用。

参数类型描述是否必填
userString收银员账号的UID必填
signString签名必填
methodStringv3.CreatePaymentsWechatH5Pay必填
timeLong时间戳必填
  • 参数
参数类型描述是否必填
pay_methodStringonline必填
sub_pay_methodStringWeChat Pay必填
order_idString商户的订单ID必填
amountString金额数字。例如 € 24.99 应该写成24.99,CNY金额>=1,欧元金额>=0.1必填
currencyStringE货币代码,ISO 4217,例如EUR,CHF必填
descriptionString订单描述必填
demoString自定义字段选填
timeoutString过期时间单位分钟(0-1440)必填
notify_urlString支付完成后异步通知地址必填
redirect_urlString支付完成后跳转地址选填
ip_addressStringIp地址必填

签名示例:

拼接为URL方式并排序后的字符串

"amount=0.1&currency=EUR&demo=test&description=YabandPay test&ip_address=127.0.0.1&method=v3.CreatePaymentsWechatH5Pay&notify_url=https://www.yabandpay.com/notify&order_id=202487816549841654&pay_method=online&redirect_url=https://www.yabandpay.com&sub_pay_method=WeChat Pay&time=1555498137&timeout=0&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下:

"YOUR_SIGNATURE"

提交示例:

 {
  "user": "YOUR_CASHIER_UID",
  "sign": "YOUR_SIGNATURE",
  "method": "v3.CreatePaymentsWechatH5Pay",
  "time": 1555498137,
  "data": {
    "amount": "0.1",
    "currency": "EUR",
    "demo": "test",
    "description": "YabandPay test",
    "notify_url": "https://www.yabandpay.com/notify",
    "order_id": "YOUR_ORDER_ID",
    "pay_method": "online",
    "redirect_url": "https://www.yabandpay.com",
    "sub_pay_method": "WeChat Pay",
    "timeout": "0",
    "ip_address" : "127.0.0.1"
  }
}

返回示例:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "ced03b0a-3bb1-ce9b-237e-eed85f4b7e33",
        "amount": "0.10",
        "currency": "EUR",
        "parameters": {
            "pay_url": "https://pay.yabandpay.com/payments/wechat_native_callback/order/M80d5a3f88dfb16716f04479e36dda8d79fbea0dc52cf8d902bd3330bb41"
        },
        "state": "processing"
    },
    "message": ""
}

请将pay_url参数返回给H5的对应接口拉起微信支付。

更多信息:

返回结果:
  1. 若调用成功,则返回"status": true

  2. 若调用失败,则返回"status": false

我们强烈建议同时使用订单查询和异步通知来同步和更新支付状态,以确保支付信息的实时准确性。

返回代码:
StatusCodeMessage
true200Success
false-1000Internal error
false-3001Required field is missing
false-403The signature Error
false-4011Not support the payment method