退款订单查询

4.1) 请求地址

https://api.4pyun.com/gate/1.0/payment/trade/refund

4.2) 调用方式

HTTP GET

4.3) 特殊说明

1:app_id,app_secret 应用id和加密密钥由平台方提供，对接方需提供公司全称然后给到商务提交给研发申请
2:该退款查询接口只允许查询已授权商户的订单，请联系研发进行授权配置

4.4) 请求参数

4.5）请求示例

签名算法：
1. 设所有发送或接收到的数据为集合M，将集合M内非空参数值的参数按照参数名 ASCII码 从小到大排序（字典序），使用 URL键值对 的格式（即 key1=value1&key2=value2...）拼接成字符串 stringA。
2. sign = stringA + "&app_secret=" + appSecret，取 MD5（32位不区分大小写）。

注意事项：
1. 参数名 ASCII码 从小到大排序（字典序）；
2. 如果参数值为空（即null）不参与签名；
3. 参数名区分大小写；
4. 验证签名时，sign 参数不参与签名，将生成的签名与该 sign 值作校验；
5. 接口可能增加字段，验证签名时必须支持增加的扩展字段；

    @Test
    public void testRefundQuery() {
        String url = "https://dev-api.4pyun.com/gate/1.0/payment/refund/create";
        String appId = "op00961963581daa7";
        String appSecret = "6409292d66625a2a0912acfc61ed956c";

        Map<String, String> paramMap = Maps.newTreeMap();
        // 应用ID
        paramMap.put("app_id", appId);
        // 退款订单所属商户号
        paramMap.put("merchant", "62626601");
        // 退款请求单号
        paramMap.put("order", "TEST_20240320145031953");

        // 生成待签名参数
        String str = StringUtils.join(paramMap, "&", "=") + "&app_secret=" + appSecret;
        System.out.println("encryptStr: " + str);

        // 生成签名
        String sign = MD5.encryptHEX(str);
        System.out.println("sign: " + sign);
        paramMap.put("sign", sign);

        // 组装请求URL
        String requestUrl = UrlUtils.build(url, paramMap);

        try {
            System.out.println("Request: " + requestUrl);
            HttpResponse httpResponse = Request.Get(requestUrl)
                    .execute()
                    .returnResponse();
            String responseBody = EntityUtils.toString(httpResponse.getEntity());
            System.out.println("Response: " + responseBody);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

4.6) 请求返回结果参数说明

4.7) 请求返回结果示例:

查询成功
{
    "code": "1001",
    "seqno": "60661674882214038340794721836706",
    "data_node": "CN-South/DEV-3",
    "time_cost": 14,
    "payload": {
        "order": "TEST_20240321165705440",
        "refund_order": "20240321165706075524320",
        "refund_serial": "1770736381283725312",
        "pay_serial": "20240321165625066020110009",
        "value": 1,
        "process": 1,
        "create_time": "2024-03-21T08:57:06Z",
        "refund_time": "2024-03-21T08:57:08Z",
        "operator_id": "op94450a8603f8843",
        "operator_name": "测试应用",
        "reason": "测试退款",
        "merchant": "97919537",
        "receipt_url": ""
    }
}

参数错误
{
    "code": "1400",
    "message": "`order` is required",
    "seqno": "28610145597796892868994206094424",
    "data_node": "CN-South/DEV-3",
    "time_cost": 116,
    "payload": {
        "order": "",
        "refund_order": "",
        "refund_serial": "",
        "pay_serial": "",
        "value": 0,
        "process": 0,
        "operator_id": "",
        "operator_name": "",
        "reason": "",
        "merchant": "",
        "receipt_url": ""
    }
}

退款订单不存在
{
    "code": "1002",
    "message": "退款订单不存在",
    "hint": "merchant=97919537, order=TEST_20240321165705441",
    "seqno": "41233945733378583301176401889043",
    "data_node": "CN-South/DEV-3",
    "time_cost": 6,
    "payload": {
        "order": "",
        "refund_order": "",
        "refund_serial": "",
        "pay_serial": "",
        "value": 0,
        "process": 0,
        "operator_id": "",
        "operator_name": "",
        "reason": "",
        "merchant": "",
        "receipt_url": ""
    }
}

没有该订单退款权限
{
    "code": "1403",
    "message": "该商户未授权该应用",
    "hint": "app_id=op94450a8603f8843, merchant=17627004",
    "seqno": "91250735701538035211017554555339",
    "data_node": "CN-South/DEV-3",
    "time_cost": 603,
    "payload": {
        "order": "",
        "refund_order": "",
        "refund_serial": "",
        "pay_serial": "",
        "value": 0,
        "process": 0,
        "operator_id": "",
        "operator_name": "",
        "reason": "",
        "merchant": "",
        "receipt_url": ""
    }
}