订单及明细查询接口

1.修订记录

2、业务说明

（1）场景说明

1、需要查询订单及明细状态，调用此接口

（2）接口说明

1、订单及明细查询接口

3.请求地址

4、参数说明

4.1 公共请求参数

4.2 业务请求参数

参数名biz_content,值为一个json格式对象，下面列表描述json对象的值

5、响应参数说明

银盛支付对商户的请求数据处理完成后，会将处理的结果数据同步回执给商户。

请注意：银盛后期会对返回参数保留扩展的权力，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。

5.1 公共响应参数

5.2 业务响应参数

5.1 分期信息 InstallmentResp

5.2 支付明细 pay_detail_list

5.2.1 支付宝 alipay_coupon_info

5.2.1.1 AlipayTradeFundBill

5.2.1.2 VoucherDetail 说明

5.2.2 alipay_coupon_good_detail

type参数说明：“WXRESP”:微信单品营销渠道响应；“ALIRESP”:支付宝单品营销渠道响应；"UNION_PAY_RESP"：银联单品营销渠道响应

5.2.2.1 type为“ALIRESP”时响应参数goodsDetailJson说明

5.2.2.2 type为“WXRESP”时响应参数goodsDetailJson说明

5.2.2.3 type为“UNION_PAY_RESP”时响应参数goodsDetailJson说明

5.2.3 银联 CupQrCouponDetail

5.2.4 银联 CouponInfo

5.2.4.1 CupQrCouponDetail

5.2.4.2 IssAddnData

5.2.4.2.1 DctDetail说明

5.2.4.3 CupAcpCouponInfo说明

5.2.5 微信营销 wxpay_coupon_info

5.2.5.1 参数 promotionDetail

5.2.6 微信营销列表 wxpay_coupon_good_detail

5.3 快付明细 quick_pay_detail_list

6.样例

6.1 pay_detail_list 字段

[{
    "state": "TRADE_FAILED",
    "trade_no": "01O190531055885032",
    "seq": 1
}, {
    "state": "TRADE_SUCCESS",
    "trade_no": "01O190531055885032",
    "seq": 2
}]

6.2 wxpay_coupon_info 字段

{
    "cash_fee": 22.09,
    "cash_fee_type": "CNY",
    "coupon_fee": 4,
    "fee_type": "CNY",
    "promotionDetails": [{
        "activity_id": "72560",
        "amount": 4,
        "merchant_contribute": 0,
        "name": "21--30 单品免充 4",
        "other_contribute": 4,
        "promotion_id": "0219457",
        "scope": "SINGLE",
        "type": "DISCOUNT",
        "wxpay_contribute": 0
    }],
    "settlement_total_fee": 22.09,
    "total_fee": 26.09
}

8.3 wxpay_coupon_good_detail 字段

6.3 SDK调用示例

    @Test
    public void orderAndDetailQueryTest() throws Exception {
        /** 组装参数 */
        OnlineReqDataVo reqDataVo = new OnlineReqDataVo();

        //二维码支付请求地址
        reqDataVo.setReqUrl("https://search.ysepay.com/gateway.do");

        //商户在银盛支付平台开设的用户号[商户号]
        reqDataVo.setPartnerId("hyfz_test2");

        //客户端私钥证书路径: 证书在入网流程中自己申请的
        reqDataVo.setPrivateKeyFilePath("E:/data/online/hyfz_test2.pfx");

        //客户端私钥密钥: 私钥密钥在入网流程中自己申请私钥证书时填写的
        reqDataVo.setPrivateKeyPassword("123456");

        //银盛公钥证书路径: 证书入网申请后发放
        reqDataVo.setYsPublicKeyFilePath("E:/data/online/businessgate.cer");

        //业务参数: 业务参数说明详细见接口文档
        /** -----------组装业务参数开始 -------------*/
        Map<String,Object> params = new HashMap<>();
        //商户生成的订单号，生成规则前8位必须为交易日期，如20180525，范围跨度支持包含当天在内的前后一天，且只能由大小写英文字母、数字、下划线及横杠组成
        params.put("out_trade_no","201805256843192280647118");
        //商户日期(该参数做交易与查询时需要一致) 该日期需在当日的前后一天时间范围之内
        params.put("shopdate","20180525");
        //银盛交易号 特殊可选
        params.put("trade_no","311160414497667096");
        reqDataVo.setParamData(params);
        /** -----------组装业务参数结束 -------------*/

        /**2、调用API的方法*/
        String result = null;
        try{
            System.out.println("单笔订单+明细查询接口-调用sdk接口orderAndDetailQuery请求入参为:"+ JSONObject.toJSONString(reqDataVo));
            result = OrderQueryApi.orderAndDetailQuery(reqDataVo);
            //根据返回结果处理自己的业务逻辑,result内容详见接口文档
        }catch (Exception e){
            //根据自己要求处理进件失败的业务逻辑
            System.out.println("单笔订单+明细查询接口失败:"+e.getCause().getMessage());
        }
        System.out.println("结果返回:"+result);
    }

7.附录

7.1 支付状态(非快付)

7.2 支付状态(快付)

7.3 快付状态

7.4 交易状态(非快付)

7.5 交易状态(快付)

7.6 订单及明细查询错误码

7.7 交易扩展状态（trade_status_ext）