API REFERENCE

Pagos en la aplicación

YabandPay documentation·Actualizado el 26 oct 2026

Parámetros

Parameter	Type	Descripción	Obligatorio
data.pay_method	string	online	✓
data.sub_pay_method	string	Alipay	✓
data.sub_pay_method_type	string	参考支持的钱包列表	—
data.order_id	string	商户的订单ID	✓
data.amount	string	金额数字。例如 € 24.99 应该写成24.99，CNY金额>=1，欧元金额>=0.1	✓
data.currency	string	货币代码，ISO 4217，例如EUR，CHF	✓
data.description	string	订单描述	✓
data.demo	string	自定义字段	—
data.timeout	string	过期时间单位分钟(0-1440)	✓
data.notify_url	string	支付完成后异步通知地址	✓
data.redirect_url	string	支付完成后跳转地址；IOS和Android注意：回调到APP处理的，需要applink或者deeplink做回调处理	—
data.os_type	string	安卓端传android 苹果端传ios	✓

Parámetro	Tipo	Descripción	Obligatorio
user	String	Cuenta de cajero UID	Obligatorio
sign	String	Signature	Obligatorio
method	String	v3.CreatePaymentsAlipayAppPay	Obligatorio
time	Long	Timestamp	Obligatorio

Parámetros

Parámetro	Tipo	Descripción	Obligatorio
pay_method	String	online	Obligatorio
sub_pay_method	String	Alipay	Obligatorio
sub_pay_method_type	String	See the list of supported wallets	Opcional
order_id	String	ID de pedido del comercio	Obligatorio
amount	String	Importe numérico. Por ejemplo, € 24.99 debe indicarse como 24.99; CNY amount>=1, importe en euros >=0.1	Obligatorio
currency	String	ISO 4217 código de moneda, como EUR or CHF	Obligatorio
description	String	Descripción del pedido	Obligatorio
demo	String	Campo personalizado	Opcional
timeout	String	Tiempo de expiración en minutos (0-1440)	Obligatorio
notify_url	String	URL de notificación asíncrona tras completarse el pago	Obligatorio
redirect_url	String	URL de redirección tras completarse el pago. For IOS and Android: use an applink or deeplink to handle callbacks to the APP	Opcional
os_type	String	Pass android for Android and ios for Apple	Obligatorio

Ejemplo de firma:

Parámetros ordenados y concatenados en una cadena de consulta con formato de 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"

Firme la cadena A con secret_key

La firma resultante es:

"YOUR_SIGNATURE"

Ejemplo de solicitud:

{
    "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"
    }
}

Ejemplo de respuesta:

{
  "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": ""
}

Información adicional:

If your APP uses a webview, redirect directly to pay_url.

If your APP is developed for IOS or Android, download the corresponding SDK: Download .

Refer to the official AliPay+ documentation for integration.

Resultado de la respuesta:

Una solicitud correcta devuelve "status": true.
Una solicitud fallida devuelve "status": false.

Recomendamos encarecidamente utilizar tanto Consulta de pedido and Notificaciones asíncronas para mantener los estados de pago precisos y actualizados.

Wallets supported by Alipay+:

The wallets corresponding to sub_pay_method_type support the following payment scenarios:

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	✅	✅	✅	✅

Códigos de respuesta:

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

Pagos en la aplicación