API REFERENCE

Pagos nativos

YabandPay documentation·Actualizado el 26 oct 2026

Parámetros

Parameter	Type	Descripción	Obligatorio
data.order_id	string	商户的订单ID	✓
data.url_type	string	默认01， 01:返回的url直接跳转到YabandPay托管页面；02:微信原生的二维码URL	—
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	支付完成后跳转地址	—

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

Parámetros

Parámetro	Tipo	Descripción	Obligatorio
order_id	String	ID de pedido del comercio	Obligatorio
url_type	String	Default: 01. 01: the returned url redirects directly to the YabandPay hosted page; 02: native WeChat QR code URL	Opcional
amount	String	Importe como cadena numérica. Por ejemplo, introduzca 24.99 for € 24.99. importe en CNY >=1; importe en EUR >=0.1.	Obligatorio
currency	String	ISO 4217 código de moneda, por ejemplo 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 el pago	Obligatorio
redirect_url	String	URL de redirección tras el pago	Opcional

Ejemplo de firma:

Parámetros ordenados y concatenados en una cadena de consulta con formato de URL

"amount=1&currency=EUR&description=yaband test&method=v3.CreateWechatNativePay&notify_url=https://www.yabandpay.com/notify&order_id=2024821984761654842&redirect_url=https://www.yabandpay.com&time=1568553105&timeout=0&user=h5@yaband.com"

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.CreateWechatNativePay",
    "time": 1568553105,
    "data": {
            "url_type": "01",
            "order_id": "YOUR_ORDER_ID",
            "amount": "1",
            "currency": "EUR",
            "timeout": "0",
            "description": "yaband test",
		    "redirect_url": "https://www.yabandpay.com",
		    "notify_url": "https://www.yabandpay.com/notify"
    }
}

Ejemplo de respuesta:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "289c6441-056e-676e-80e6-672651911070",
        "amount": "1.00",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/payments/wechat_native_callback/order/Mjg5YzY0NDEtMDU2ZS02NzZlLTgwZTYtNjcyNjUxOTExMDcw",
        "state": "processing"
    },
    "message": ""
}

Información adicional:

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.

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 nativos

Pagos nativos

Request parameters8

Native支付

Parámetros

Ejemplo de firma:

Ejemplo de solicitud:

Ejemplo de respuesta:

Información adicional:

Resultado de la respuesta:

Códigos de respuesta: