API REFERENCE

二维码支付

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

适用于线下门店支付场景

小贴士

请将返回的url（或将url转换成二维码）以及可用支付方式的icon展示给用户。

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

参数

Parameter	Type	Description	是否必填
pay_method	String	offline	必填
sub_pay_method	String	QRcode	必填
order_id	String	商户的订单ID	必填
amount	String	金额数字。例如 € 24.99 应该写成24.99，CNY金额>=1，欧元金额>=0.1	必填
tip_amount	String	总金额中包含的小费，金额数字。例如 1.02	选填
currency	String	货币代码，ISO 4217，例如EUR，CHF	必填
description	String	订单描述	必填
demo	String	自定义字段	选填
timeout	String	过期时间单位分钟(0-1440)	必填
redirect_url	String	支付完成后跳转地址	选填
notify_url	String	支付完成后异步通知地址	必填

签名示例：

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

 "amount=12.1&currency=EUR&demo=test&description=YabandPay test&method=v3.QRcodePayment&notify_url=https://www.yabandpay.com/notify&order_id=202486556498441613&pay_method=offline&redirect_url=https://www.yabandpay.com&sub_pay_method=QRcode&time=1555498137&timeout=0&tip_amount=0.5&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

 {
  "user": "YOUR_CASHIER_UID",
  "sign": "YOUR_SIGNATURE",
  "method": "v3.QRcodePayment",
  "time": 1555498137,
  "data": {
    "amount": "12.1",
    "currency": "EUR",
    "tip_amount": "0.5",
    "demo": "test",
    "description": "YabandPay test",
    "notify_url": "https://www.yabandpay.com/notify",
    "order_id": "YOUR_ORDER_ID",
    "pay_method": "offline",
    "redirect_url": "https://www.yabandpay.com",
    "sub_pay_method": "QRcode",
    "timeout": "0"
  }
}

返回示例：

{
  "status": true,
  "code": "200",
  "data": {
    "order_id": "YOUR_ORDER_ID",
    "trade_id": "4552eeea-1ae8-1e40-3b4b-802dc2f5686a",
    "amount": "12",
    "currency": "EUR",
    "tip_amount": "0.5",
    "url": "https://pay.yabandpay.com/payments/selectpay/order/ODlmYmYyMzQtN2U1Yy00ZDI5LTM5NWMtNGI4NzljYjI4MDlj",
    "available_payment_methods": "Alipay+, Wechat Pay, iDEAL, UnionPay, QuickPass, Bancontact, Visa, Mastercard, ApplePay, GooglePay",
    "state": "processing"
  },
  "message": ""}

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

二维码支付

二维码支付

请求参数10

二维码支付

签名示例：

提交示例：

返回示例：

更多信息：

返回结果：

返回代码：