跨境汇款-明细批次查询-API

接口描述

此接口支持API跨境汇款明细记录信息的查询

跨境汇款-明细批次查询

基本信息

测试请求地址 https://cbtrxtest.helipay.com/cbtrx/rest/crossBorder/detailBatchQuery
请求地址 http://cbptrx.helipay.com/cbtrx/rest/crossBorder/detailBatchQuery
提交方式 采用POST方法提交,requestbody传值 Content-Type=[application/json;charset=UTF-8]
签名算法 UTF-8字符编码 SHA256签名 AES加密

请求参数

名称 参数 类型 必填 示例值 说明
商户编号 merchantNo String(10) Me10000002 合利宝-跨境系统分配的商户编号
订单号 orderNo String(64) p_20170302185347
产品编码 productCode String(20) RMBCROSS 固定值
明细批次流水号 serialNo String(64) 商户上传明细时,合利宝返回的批次流水号

响应参数

名称 参数 类型 必填 示例值 说明
返回码 errorCode String(20)
返回信息 errorMessage String(64)
商户编号 merchantNo String 合利宝-跨境系统分配的商户编号
产品编码 productCode String RMBCROSS 固定值-RMBCROSS
明细批次流水号 serialNumber String 商户上传明细时,合利宝返回的批次流水号
批次校验结果 checkResult String 校验通过:XX条,金额XX;校验不通过:XX条,金额XX;待校验:XX条,金额XX
批次失败明细请求号 checkResultSer String 2001,2002, 非校验通过的明细的请求流水号汇总

代码示例


                                    /**
     * 明细批次查询
     * @return
     */
    @RequestMapping("/toRmbCrossDetailBatchQuery")
    public ModelAndView toRmbCrossDetailBatchQuery() {
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.setViewName("rmbcross/rmbCrossDetailBatchQuery");
        return modelAndView;
    }
    @RequestMapping(value = "/rmbCrossDetailBatchQuery" , method = RequestMethod.POST)
    public ModelAndView rmbCrossDetailBatchQuery(@ModelAttribute @Valid RmbCrossDetailQueryDTO queryForm, BindingResult bindingResult) throws UnsupportedEncodingException {
        ModelAndView modelAndView = new ModelAndView();
        if (bindingResult.hasErrors()) {
            throw new CommonSystemException(CommonSystemException.ILLEGAL_DATA_REQUEST[0], bindingResult.getFieldError().getDefaultMessage());
        }
        HeliRequest result = HandleDataUtils.encodeAndSign(queryForm, queryForm.getProductCode(), queryForm.getPlatMerchantNo(), queryForm.getMerchantNo());
        HeliRequest heliRequest = remoteService.postRemoteInvoke(LoadPropertiesUtils.getProperty("rmbCrossDetailBatchQuerylUrl"), JSONObject.toJSONString(result), HeliRequest.class);
        RmbCrossDetailBatchQueryResponseForm responseForm = HandleDataUtils.decode(heliRequest, RmbCrossDetailBatchQueryResponseForm.class, queryForm.getProductCode(), queryForm.getPlatMerchantNo(), queryForm.getMerchantNo());
        if (!CbDemoConstants.SUCCESS_CODE.equals(responseForm.getErrorCode())) {
            throw new CommonSystemException(responseForm.getErrorCode(),responseForm.getErrorMessage());
        }
        logger.info("返回详细信息------------{}",responseForm.toString());

        modelAndView.addObject("responseForm", responseForm);
        modelAndView.setViewName("rmbcross/rmbCrossDetailBatchQueryResult");
        return modelAndView;
    }

                                

                                

                                

错误码

错误码 错误码描述 解决方案