API REFERENCE

In-App支付

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

参数	类型	描述	是否必填
user	String	收银员账号的UID	必填
sign	String	签名	必填
method	String	v3.CreatePaymentsAlipayAppPay	必填
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)	必填
notify_url	String	支付完成后异步通知地址	必填
redirect_url	String	支付完成后跳转地址；IOS和Android注意：回调到APP处理的，需要applink或者deeplink做回调处理	选填
os_type	String	安卓端传android 苹果端传ios	必填

签名示例：

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

"amount=1&currency=EUR&description=YabandPay test&method=v3.CreatePaymentsAlipayAppPay&notify_url=https://www.yabandpay.com/notify&order_id=202412654894165484&os_type=ios&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&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.CreatePaymentsAlipayAppPay",
    "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/redirect_url",
        "os_type": "ios"
    }
}

返回示例：

{
  "status": true,
  "code": "200",
  "data": {
    "order_id": "YOUR_ORDER_ID",
    "trade_id": "e5baf40b-08b2-4660-ed20-d632eeeceab3",
    "amount": "0.01",
    "currency": "EUR",
    "parameters": {
      "pay_url": "https://open-sea-global.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040097PyqF6IxZEzTURq7PhvTv3ken",
      "payments_data": "{\"displayPaymentAmount\":\"0.01\",\"displayPaymentCurrency\":\"EUR\",\"wallets\":[{\"enabled\":true,\"promoNames\":[\"{\\\"en_US\\\":\\\"test\\\",\\\"nl_NL\\\":\\\"test\\\"}\"],\"searchKeywords\":[\"dana wallet\"],\"walletName\":\"DANA\"}]}"
    },
    "state": "processing"
  },
  "message": ""
}

更多信息：

如果您的APP是采用webview方式，请直接跳转pay_url

如果您的APP是IOS和Android开发，请下载对应的SDK：Download .

请参考AliPay+的官方文档进行集成

返回结果：

若调用成功，则返回"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