API REFERENCE

Transferencia bancaria

YabandPay documentation·Actualizado el 26 oct 2026

Parámetros

Parameter	Type	Descripción	Obligatorio
data.request_id	string	请求id需保持唯一，建议24以上位数字+字母	✓
data.pay_method	string	online	✓
data.sub_pay_method	string	Bank Transfer	✓
data.order_id	string	商户的订单ID	✓
data.amount	string	金额数字。例如 € 24.99 应该写成24.99，欧元金额>=1	✓
data.currency	string	EUR	✓
data.description	string	订单描述	✓
data.email	string	用户邮箱	—
data.demo	string	自定义字段	—
data.timeout	string	过期时间单位分钟(0-1440)	✓
data.redirect_url	string	支付完成后跳转地址	—
data.notify_url	string	支付完成后异步通知地址	✓

Se aplica a: transferencias bancarias de usuarios

Paybybank es un método seguro de pago por transferencia bancaria ofrecido por YabandPay. Los clientes pagan transfiriendo fondos directamente desde sus cuentas bancarias a la cuenta designada de YabandPay.

Esta solución es ideal para comercios que buscan reducir costes y realizar transacciones fiables sin depender de redes de tarjetas. Una vez recibida la transferencia, YabandPay verifica automáticamente el pago y actualiza el estado de la transacción, ofreciendo una experiencia de pago sencilla para comercios y clientes.

Consejo

Paybybank solo admite transferencias a través de la red SEPA (Zona Única de Pagos en Euros). No se aceptan transferencias SWIFT.

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

Parámetros

Parámetro	Tipo	Descripción	Obligatorio
request_id	String	ID de solicitud único; se recomienda una combinación de letras y números de al menos 24 caracteres	Obligatorio
pay_method	String	online	Obligatorio
sub_pay_method	String	Transferencia bancaria	Obligatorio
order_id	String	ID de pedido del comercio	Obligatorio
amount	String	Importe numérico. Por ejemplo, € 24.99 debe indicarse como 24.99; importe en euros >=1	Obligatorio
currency	String	EUR	Obligatorio
description	String	Descripción del pedido	Obligatorio
email	String	User email address	Opcional
demo	String	Campo personalizado	Opcional
timeout	String	Tiempo de expiración en minutos (0-1440)	Obligatorio
redirect_url	String	URL de redirección tras el pago	Opcional
notify_url	String	URL de notificación asíncrona tras el pago	Obligatorio

Ejemplo de firma:

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

"amount=0.1&currency=EUR&demo=test&description=Test&email=info@yabandmedia.com&method=v3.BankTransfer&notify_url=https://www.yabandpay.com/notify&order_id=12455555788&pay_method=online&redirect_url=https://www.yabandpay.com&request_id=001123456789&sub_pay_method=Bank Transfer&time=1653145918&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",
    "method": "v3.BankTransfer",
    "time": "1653145918",
    "sign": "YOUR_SIGNATURE",
    "data": {
        "request_id": "001123456789",
        "order_id" : "YOUR_ORDER_ID",
        "pay_method": "online",
        "sub_pay_method": "Bank Transfer",
        "email": "info@yabandmedia.com",
        "description": "Test", 
        "timeout" : "0",
        "amount": "0.1",
        "currency": "EUR",
        "redirect_url": "https://www.yabandpay.com",
        "notify_url" : "https://www.yabandpay.com/notify",
        "demo": "test"
    }
}

Ejemplo de respuesta:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "d3a81009-2b3c-9f2c-8e33-45dc932ee757",
        "amount": "0.10",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/prod/bank_transfer/ZDNhODEwMDktMmIzYy05ZjJjLThlMzMtNDVkYzkzMmVlNzU3",
        "state": "processing"
    },
    "message": "",
    "response_id": "202505131817352897785689"
}

Información adicional:

Resultado de la respuesta:

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

We recommend using Notificaciones asíncronas to update the payment status and keep payment information accurate in real time.

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

Transferencia bancaria