退款订单查询

1 请求地址

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

2 请求方式

HTTP GET

3 注意事项

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

4 请求参数

5 请求示例

签名算法与注意事项见签名算法。本接口为 URL 传参，签名值通过 URL 参数 sign 传递。

@Test
    public void testRefundQuery() {
        // 支付接口使用支付接入网关
        String url = "https://papi.4pyun.com/gate/1.0/payment/trade/refund";
        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();
        }
    }

6 响应参数

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": "",
        "fee": 0
    }
}

参数错误
{
    "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": "",
        "fee": 0
    }
}

退款订单不存在
{
    "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": "",
        "fee": 0
    }
}

没有该订单退款权限
{
    "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": "",
        "fee": 0
    }
}