公用接口-牌价查询

  1. 主页
  2. 牌价查询

接口描述

跨境系统实时外币牌价查询

基本信息

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

请求参数

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) 是 RMBCROSS 对应的产品编码
商户订单号 orderNo String(64) 是 p_20170302185347 原交易订单号
商户编号 merchantNo String(10) 是 Me10000002 合利宝-跨境系统分配的商户编号
客户买入币种 buyCurrency String(15) 否 USD 客户买入币种币别

响应参数

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) 是 RMBCROSS 对应的产品编码
商户订单号 orderNo String(64) 是 Test20180401hlp 原交易订单号
商户编号 merchantNo String(10) 是 Me10000018 合利宝-跨境系统分配的商户编号
响应码 errorCode String(10) 是 0000 0000 代表请求成功
响应信息 errorMessage String(200) 否 成功 响应信息 错误信息
响应时间 current String(20) 是 2018-04-01 12:00:00 格式yyyy-MM-dd HH:mm:ss
牌价明细 detailList List 否 详见下面说明 实时外币牌价

牌价明细

名称 参数 类型 必填 示例值 说明
兑换币别 currency Currency 否 USD 外币币种
现汇买入价 buyPrice Number(19,4) 否 451.5900
现汇卖出价 sellPrice Number(19,4) 否 670.8200
发布时间 publishDate String(20) 否 2018-04-01 12:00:00 格式yyyy-MM-dd HH:mm:ss

代码示例

    @Test
    public void queryExchangePrice() {
        RemoteServiceImpl remoteService = new RemoteServiceImpl();
        HeliRequest heliRequest = remoteService.postRemoteInvoke(LoadPropertiesUtils.getProperty("exchangeQueryUrl"), installDto(), HeliRequest.class);
        ResponseBase form = decode(heliRequest, ResponseBase.class, heliRequest.getProductCode(), heliRequest.getMerchantNo());
        logger.info("#####解密后的内容为{}", form.toString());
    }

    public static String installDto() {
    	ExchangeQueryRequestForm form = new ExchangeQueryRequestForm();
    	form.setProductCode(ProductEnumType.RMBCROSS.name());
    	form.setMerchantNo("Me10000018");
    	form.setOrderNo("Test20180401hlp");
    	form.setBuyCurrency("USD");
        return JSONObject.toJSONString(encodeAndSign(form, form.getProductCode(), form.getMerchantNo()));
    }

错误码

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