API REFERENCE

退款查询

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

参数	类型	描述	是否必填
user	String	收银员账号的UID	必填
sign	String	签名	必填
method	String	v3.QueryRefundOrder	必填
time	Long	时间戳	必填

参数

参数	类型	描述	是否必填
refund_id	String	YabandPay退款单号	选填（必须包含一个）
m_refund_id	String	商户退款单号	选填（必须包含一个）

签名示例：

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

"method=v3.QueryRefundOrder&time=1728566835&refund_id=3841510a-4d18-4a61-808d-431a45006de2&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

{
    "user": "YOUR_CASHIER_UID",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.QueryRefundOrder",
    "time": 1728566835,
    "data": {
        "refund_id": "3841510a-4d18-4a61-808d-431a45006de2"
    }
}

返回示例：

{
    "status": true,
    "code": "200",
    "data": {

            "transaction_id": "20240903153820059756",
            "refund_id": "20240903154342497308",
            "m_refund_id": null,
            "refund_time": "1725349422",
            "state": "refunded",
            "refund_amount": "0.01",
            "refund_currency": "EUR",
            "refund_description": "gary",
            "notify_url": "null",
            "demo": "",
            "settlement_refund_amount": "0.01",
            "settlement_refund_currency": "EUR",
            "merchant_cost": "0.1",
            "yb_transaction_id": "c07859aa-3d12-69d4-ef2f-a9556d9c4d33"
        },
    "message": ""
}

更多信息：

返回结果：

若调用成功，则返回"status": true
若调用失败，则返回"status": false

退款状态：

Code	State	Message
20	to-be-approval	等待管理员批准。
21	refund pending	当前余额不足，余额充足时自动提交退款。
22	refund processing	退款请求已经提交，系统正在处理中。
23	refunded	退款已经成功完成。
24	refund failed	退款失败，请再次尝试。
25	refund error	退款失败，请联系我们在线客服。
26	refund cancelled	退款订单已经被取消。