退款查询

退款查询接口用于查询退款申请的处理状态和详细信息。

接口信息

• 接口地址：

/zro/trade/refund-query

• 请求方式：POST
• Content-Type：application/json

请求参数

公共参数

参数名	类型	必填	描述
merchantNo	String	是	商户号
sign	String	是	签名

请求示例

{
  "merchantNo": "1082372921",
  "sign": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6"
}

响应参数

成功响应

参数名	类型	描述
code	Number	响应码，6000 表示成功
message	String	响应信息
result	Object	退款信息

退款信息（result）

参数名	类型	描述
refundNo	String	嗖付退款单号
orderNo	String	商户订单号
refundMoney	Number	退款金额，单位：元
refundStatus	String	退款状态
description	String	退款描述
createTime	String	退款申请时间
successTime	String	退款成功时间

响应示例

{
  "code": 6000,
  "message": "查询成功",
  "result": [
    {
      "order_no": "202xxx229xx50016xxx30xx0",
      "refund_no": "RD20xx22415094047xx07586803xx32",
      "refund_price": "239.00",
      "refund_description": "",
      "refund_status": "SUCCESS"
    }
  ],
  "request_id": "399xx4bd-16b9-4a9d-987e-7xxd18484",
  "timestamp": "2025-02-25 14:59:27"
}

代码示例

Java 示例

QueryRefundResponse response = client.queryRefund();
if (response.getCode() == 6000) {
    for (RefundRecord record : response.getResult()) {
        System.out.println("退款单号：" + record.getRefundNo());
        System.out.println("退款状态：" + record.getRefundStatus());
    }
}

PHP 示例

$response = $client->queryRefund();
if ($response['code'] === 6000) {
    foreach ($response['result'] as $record) {
        echo "退款单号：{$record['refund_no']}\n";
        echo "退款状态：{$record['refund_status']}\n";
    }
}

相关接口

• 申请退款 - 发起退款申请