API REFERENCE

小程序支付

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

小贴士

仅限支付宝中国钱包，不支持支付宝+的其它钱包。接入支付宝+小程序请参考支付宝+官方文档（https://miniprogram.alipay.com/docs-alipayconnect/miniprogram_alipayconnect/solutions/cn-cashier-payment）

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

参数

参数	类型	描述	是否必填
pay_method	String	online	必填
sub_pay_method	String	Alipay	必填
sub_pay_method_type	String	参考支持的钱包列表	选填
order_id	String	商户的订单ID	必填
amount	String	金额数字。例如 € 24.99 应该写成24.99，CNY金额>=1，欧元金额>=0.1	必填
currency	String	货币代码，ISO 4217，例如EUR，CHF	必填
description	String	订单描述	必填
demo	String	自定义字段	选填
timeout	String	过期时间单位分钟(0-1440)	必填
redirect_url	String	支付完成后跳转地址	选填
notify_url	String	支付完成后异步通知地址	必填

签名示例：

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

"amount=1&currency=EUR&description=YabandPay test&method=v3.CreatePaymentsAlipayMiniPay&notify_url=https://www.yabandpay.com/notify&order_id=2024519846516588484&pay_method=online&redirect_url=https://www.yabandpay.com&sub_pay_method=Alipay&time=1546588959&timeout=0&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

{
	"user": "YOUR_CASHIER_UID",
	"sign": "YOUR_SIGNATURE",
	"method": "v3.CreatePaymentsAlipayMiniPay",
	"time": 1546588959,
	"data": {
		"description": "YabandPay test",
		"timeout": "0",
		"pay_method": "online",
		"sub_pay_method": "Alipay",
		"order_id": "YOUR_ORDER_ID",
		"amount": "1",
		"currency": "EUR",
		"notify_url": "https://www.yabandpay.com/notify",
		"redirect_url": "https://www.yabandpay.com"
	}
}

返回示例：

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "5902ea82-df87-bc30-3eef-c9cd1c64555c",
        "amount": "1",
        "currency": "EUR",
        "parameters": {
            "transaction_id": "2816660400948ddP1j0Et1lNHl2sOlC0bKn0"
        },
        "state": "processing"
    },
    "message": ""
}

更多信息：

返回结果：

若调用成功，则返回"status": true
若调用失败，则返回"status": false

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

Alipay+支持的钱包列表：

sub_pay_method_type 对应的钱包列表支持以下支付场景：

sub_pay_method_type	APP	WAP	Web	Mini Program
ALIPAY_CN	✅	❌	✅	✅
TRUEMONEY	✅	❌	✅	✅
ALIPAY_HK	✅	✅	✅	✅
TNG	✅	✅	✅	✅
GCASH	✅	✅	✅	✅
DANA	✅	✅	✅	✅
KAKAOPAY	✅	❌	✅	❌
RABBIT_LINE_PAY	✅	❌	✅	❌
BPI	❌	✅	✅	❌
BOOST	✅	✅	✅	❌
AKULAKU_PAYLATER	✅	✅	✅	❌
BILLEASE	✅	✅	✅	❌
TINABA	✅	✅	✅	❌
NAVERPAY	❌	✅	✅	❌
TOSSPAY	✅	❌	✅	✅
MPAY	✅	✅	✅	❌
KREDIVO_ID	✅	❌	✅	❌
KPLUS	✅	✅	✅	❌
HIPAY	✅	✅	✅	✅

返回代码：

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