文档中心/API 接口

API REFERENCE

小程序支付

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

小程序支付

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

请求参数10

先填写必填项

小程序支付

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.currency货币代码,ISO 4217,例如EUR,CHF
description必填stringdata.description订单描述
timeout必填stringdata.timeout过期时间单位分钟(0-1440)
notify_url必填stringdata.notify_url支付完成后异步通知地址
sub_app_id必填stringdata.sub_app_id小程序的APPID
sub_open_id必填stringdata.sub_open_id小程序获得的用户OpenID
可选参数 1
demo可选stringdata.demo自定义字段

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

小贴士

注意:请提供微信小程序Appid给YabandPay,需要开通以后才能使用。

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

签名示例:

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

"amount=1.23&currency=EUR&description=test&method=v3.CreatePaymentsWechatMiniPay&notify_url=https://imenuapi.yabandpay.com/api/Notify/yabandpay&order_id=202413271095510835&pay_method=online&sub_app_id=wx7a5355d3d2a904a4&sub_open_id=opilP5dyazU7pTpyps8TDc53OGyU&sub_pay_method=WeChat Pay&time=1732672545&timeout=300&user=011844"

得到的 stringA 使用 secret_key做签名

得到的签名如下:

"YOUR_SIGNATURE"

提交示例:

{
    "user": "011844",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.CreatePaymentsWechatMiniPay",
    "time": 1732672545,
    "data": {
        "description": "test",
        "timeout": "300",
        "pay_method": "online",
        "sub_pay_method": "WeChat Pay",
        "order_id": "YOUR_ORDER_ID",
        "amount": "1.23",
        "currency": "EUR",
        "notify_url": "https://imenuapi.yabandpay.com/api/Notify/yabandpay",
        "sub_open_id": "opilP5dyazU7pTpyps8TDc53OGyU",
        "sub_app_id": "wx7a5355d3d2a904a4"
    }
}

返回示例:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "e405c9d5-069f-34f5-9eb2-16919cd7e411",
        "amount": "1.23",
        "currency": "EUR",
        "parameters": {
            "appId": "wx7a5355d3d2a904a4",
            "package": "prepay_id=wx270959141300258779d83459e08e4b0000",
            "paySign": "Av83Y6u+Ua8hkU3VyoAN5MUu7cm9vPfID8OstMkS+3BbbNnl1bax5nRapKoFTz2DUzaGyzPiT+gDUzyGW7DshqPLy+NsmKvQGSQM5vyfSjXsz5F4LKOeI3YaaUBTnVXkKX6qBrzbVUfStyjvYwtqPJUXx0X2zZEiGV5ScEf44IOmWQXeiRKyv8j34KnhMHcSFgSVAPN/B10Z1BnN34VUpak6DyaM/d0zfEkUbtODzD260An9NBSKZqAg1Wh35o/Eebqd5KoPIPX74lfRjUH4O9IZUCXnb2NqTxCR2M8j7Yx5zzz3xiQGhqEPzc7m0vXQTYv3TjD+158LeF993e/c2w==",
            "nonceStr": "0ypozLSDOzutrUA7WUI7eTfWUHtDqO9n",
            "signType": "RSA",
            "timeStamp": "1732672754"
        },
        "state": "processing"
    },
    "message": ""
}

请用返回的“parameters”的值唤起微信小程序支付。

更多信息:

返回结果:
  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