API REFERENCE

CardCheck

YabandPay documentation·Actualizado el 26 oct 2026

Parámetros

Parameter	Type	Descripción	Obligatorio
data.pay_method	string	online	✓
data.sub_pay_method	string	CardCheck	✓
data.operation	string	3	✓
data.order_id	string	商户的订单ID	✓
data.description	string	订单描述	✓
data.form_type	string	返回的url类型，默认01。 01.completed, 02.iframe	—
data.demo	string	自定义字段	—
data.timeout	string	过期时间单位分钟(0-1440)	✓
data.redirect_url	string	支付完成后跳转地址	—
data.notify_url	string	支付完成后异步通知地址	✓
data.request_id	string	请求id需保持唯一，建议24以上位数字+字母	✓

Initiate a 0-value authorization for the cardholder to validate the supplied card number. The cardholder must provide valid information to complete verification.

La verificación puede completarse mediante la página alojada por YabandPay. Los comercios pueden aceptar solicitudes de forma segura al alojar los datos sensibles sujetos a PCI DSS en el sistema de YabandPay.

Consejo

Obtain the verification result through Consulta de pedido.

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

Parámetros

Parámetro	Tipo	Descripción	Obligatorio
pay_method	String	online	Obligatorio
sub_pay_method	String	CardCheck	Obligatorio
operation	String	3	Obligatorio
order_id	String	ID de pedido del comercio	Obligatorio
description	String	Descripción del pedido	Obligatorio
form_type	String	Type of returned url; defaults to 01. 01.completed, 02.iframe	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
request_id	String	ID de solicitud único; se recomienda una combinación de letras y números de al menos 24 caracteres	Obligatorio

Ejemplo de firma:

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

"description=cardcheck test&form_type=01&method=v3.CardCheck&notify_url=https://www.yabandpay.com/notify&operation=3&order_id=203040950640690239603690&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&request_id=tscqf7ki76o7aem4z1yl1xs72f89fptl&sub_pay_method=CardCheck&time=1720680417&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.CardCheck",
    "time": 1720680417,
    "data": {
        "description": "cardcheck test",
        "form_type": "01",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "CardCheck",
        "operation": "3",
        "order_id": "YOUR_ORDER_ID",
        "redirect_url": "https://www.yabandpay.com/redirect_url",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "tscqf7ki76o7aem4z1yl1xs72f89fptl"
    }
}

Ejemplo de respuesta:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "160899f3-f6d9-a8d8-ab5b-82eacdab9c5b",
        "amount": "0.00",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/payments/callback/order/MTYwODk5ZjMtZjZkOS1hOGQ4LWFiNWItODJlYWNkYWI5YzVi",
        "state": "processing"
    },
    "message": "",
    "response_id": "202407111544200649155078"
}

Información adicional:

Resultado de la respuesta:

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

Redirect to the returned url. After the user enters card details at this url and completes payment, they are redirected back to redirect_url synchronously. Recomendamos encarecidamente utilizar tanto Consulta de pedido and Notificaciones asíncronas to synchronize and update the payment status and keep payment information accurate in real time. a) If the order status state is paid, payment succeeded;

Códigos de respuesta:

Status	Code	Message
true	200
false	-1000	Internal error
false	-403	The signature Error
false	-2001	The user not exist
false	-3001	Required field is missing
false	-4118	Incorrect request ID