API REFERENCE

快捷支付

YabandPay 文档·更新于 2026年10月26日

适用于线下门店支付场景，支持微信支付、支付宝+和银联云闪付 。

字段	类型	描述	是否必填
user	String	收银员账号的UID	必填
sign	String	签名	必填
method	String	v3.BarcodePayment	必填
time	Long	时间戳	必填

参数

字段	类型	描述	是否必填
pay_method	String	offline	必填
sub_pay_method	String	WeChat Pay，Alipay，UnionPay QRcode，通过接口获取sub pay method 获取。如果为空（推荐），将由YabandPay来做支付方式判断。	选填
order_id	String	商户订单号	必填
amount	String	金额数字。例如 € 24.99 应该写成24.99，CNY金额>=1，欧元金额>=0.1	必填
tip_amount	String	总金额中包含的小费，金额数字。例如 1.02	选填
currency	String	货币代码，ISO 4217，例如EUR，CHF	必填
demo	String	自定义字段	选填
auth_code	String	微信支付或者支付宝+钱包的授权码	必填
description	String	订单描述	必填
notify_url	String	支付完成后异步通知地址	选填

签名示例：

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

"amount=2.1&auth_code=134443133735495918&currency=EUR&demo=test&description=YabandPay test&method=v3.BarcodePayment&notify_url=https://www.yabandpay.com/notify&order_id=202488465489451317&pay_method=offline&sub_pay_method=WeChat Pay&time=1555499083&tip_amount=0.5&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

{
    "user": "YOUR_CASHIER_UID",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.BarcodePayment",
    "time": 1555499083,
    "data": {
        "amount": "2.1",
        "tip_amount": "0.5",
        "auth_code": "YOUR_AUTH_CODE",
        "currency": "EUR",
        "demo": "test",
        "description": "YabandPay test",
        "notify_url": "https://www.yabandpay.com/notify",
        "order_id": "YOUR_ORDER_ID",
        "pay_method": "offline",
        "sub_pay_method": "WeChat Pay"
    }
}

返回示例：

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "511444d0-2d91-5396-9e34-f2900e80d715",
        "amount": "2.1",
        "tip_amount": "0.5",
		"sub_pay_method": "WeChat Pay",
        "state": "paid"
    },
    "message": ""}

更多信息：

返回结果：

小贴士

在用户免密码验证情况下，支付结果将同步返回。

扫码后遇到用户输入密码验证情况下，会出现支付结果state: processing，这时商户需要每隔5秒循环调用订单查询判断实际支付结果。

如果用户取消支付或累计30秒用户内仍未支付，建议商户退出查询流程后继续调用取消支付以便撤销支付交易。如果用户实际已经支付，系统将自动做退款处理。

返回代码：

Status	Code	Message
true	200	Success
false	-1000	Internal error
false	-1007	Identity code is invalid
false	-4011	Not support the payment method
false	-4015	This order has been closed
false	-4028	WeChat Pay is not available
false	-4029	Alipay is not available
false	-4086	Unknow identity code