API REFERENCE

订单查询

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

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

参数

参数	类型	描述	是否必填
trade_id	String	YabandPay订单编号	必填

签名示例：

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

"method=v3.QueryOrder&time=1728566835&trade_id=2eb629a8-96ad-d495-38f2-41f5bebf31cd&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

{
    "user": "YOUR_CASHIER_UID",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.QueryOrder",
    "time": 1728566835,
    "data": {
        "trade_id": "2eb629a8-96ad-d495-38f2-41f5bebf31cd"
    }
}

返回示例：

{
    "status": true,
    "code": "200",
    "data": {
        "transaction_info": {
            "trade_id": "2eb629a8-96ad-d495-38f2-41f5bebf31cd",
            "merchant_name": "Yaband Telecom B.V",
            "store_name": "YabandPay",
            "cashier_name": "YabandPay Test",
            "pay_method": "online",
            "sub_pay_method": "WeChat Pay",
            "order_id": "YOUR_ORDER_ID",
            "amount": "0.01",
            "tip_amount": "0.01",
            "currency": "EUR",
            "settlement_amount": "0.01",
            "settlement_currency": "EUR",
            "exchange_rate": "1",
            "description": "YabandPay Test",
            "redirect_url": "https://yabandpay.com/",
            "notify_url": "https://ordergoapi.yabandpay.com/api/Test/notify",
            "state": "paid",
            "time_out": "1440",
            "amount_cny": "0.07",
            "merchant_cost": "0.10",
            "transaction_id": "4200002425202409032894611438",
            "paid_at": "1725349108",
            "yb_transaction_id": "b228f7d3-b56b-5210-d270-5e5f23690db0",
            "icon_url": "https://partner.yabandpay.com/Public/Admin/image/wechat3x.png?v=202310201461",
            "payer_profile": {
                "payer_name": "UNKNOWN",
                "payer_ip": "208.87.243.129",
                "payer_bank_account": "451761***1527",
                "issuer_name": "",
                "expiry_month": "",
                "expiry_year": "",
                "par": "XXXXXXXXXXXXXXXXXXX"
            },
            "refund_info": [
                {
                    "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"
                }
            ],
            "createDate": "1725349082",
            "user": "YOUR_CASHIER_UID"
        }
    },
    "message": ""
}

fund_flow_status	fund_flow_description
0	uncleared
1	cleared
2	settled

订单查询

订单查询

请求参数1

订单查询

签名示例：

提交示例：

返回示例：

更多信息：

资金状态代码和描述：

参数说明：