境内收单-微信主扫下单
接口描述
商户通过本接口将订单信息上送至合利宝-跨境系统，合利宝-跨境系统调用微信下单接口生成二维码返回给商户，商户将二维码信息展示给用户，由用户扫描二维码完成订单支付。
流程图
基本信息
| 测试请求地址 | https://cbtrxtest.helipay.com/cbtrx/rest/domestic/pay/appScan |
| 请求地址 | https://cbptrx.helipay.com/cbtrx/rest/domestic/pay/appScan |
| 提交方式 | 采用POST方法提交,requestbody传值 Content-Type=[application/json;charset=UTF-8] |
| 签名算法 | UTF-8字符编码 SHA256签名 AES加密 |
请求参数
| 名称 | 参数 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|---|
| 产品编码 | productCode | String(20) | 是 | WXPAYSCAN | |
| 商户订单号 | orderNo | String(64) | 是 | p_20170302185347 | |
| 商户编号 | merchantNo | String(10) | 是 | Me10000002 | 合利宝-跨境系统分配的商户编号 |
| 订单金额 | orderAmount | Number(10.2) | 是 | 0.01 | 单位：元 |
| 商品名称 | goodsName | String(400) | 是 | Iphone7 | |
| 下单ip | orderIp | String(15) | 否 | 1.1.1.1 | |
| 有效期 | period | String(6) | 否 | 1 | 默认为7 |
| 有效期单位 | periodUnit | String(10) | 否 | HOUR | YEAR/MONTH/DAY/HOUR/MINUTE/SECOND；默认为DAY |
| 服务器回调地址 | serverCallbackUrl | String(300) | 否 | http://www.456.com | |
| 平台商户编号 | platMerchantNo | String(10) | 否 | 如下说明 | 电商平台商户所属的平台商编号 |
| 实名参数-是否实名 | certification | Boolean | 否 | 实名请求，此值必填为true | |
| 实名参数-姓名 | memberName | String(10) | 否 | 实参姓名,身份证号需同步填写 | |
| 实名参数-证件类型(固定值) | cardType | String(10) | 否 | IDCARD | 证件类型 |
| 实名参数-身份证号 | memberID | String(18) | 否 | 实参姓名,身份证号需同步填写 | |
| 实名参数-手机号 | memberMobile | String(11) | 否 | 手机号需同步填写 | |
| 报备号 | reportId | String(20) | 否 | 123123 | 产品开通后，此值会发送到商户侧，商户可选择性上送 |
| 分账请求参数明细 | shareList | List(100) | 否 | 如下说明 | 若商户开通分账产品，且本次交易需要分账，则此参数必填 |
分账请求参数明细
| 名称 | 参数 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|---|
| 排序参数 | index | Integer | 是 | 1 | 用于交易加密参数排序，不能重复 |
| 分账账户编号 | shareMerchantNo | String(10) | 是 | Me10000002 | |
| 分账金额 | shareAmount | Number(10.2) | 是 | 0.01 | 单位：元 所有明细分账金额相加必须等于交易金额 主账户分账金额必须大于交易手续费 |
响应参数
| 名称 | 参数 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|---|
| 产品编码 | productCode | String(20) | 是 | WXPAYSCAN | |
| 商户订单号 | orderNo | String(64) | 是 | p_20170302185347 | |
| 商户编号 | merchantNo | String(10) | 是 | Me10000002 | 合利宝-跨境系统分配的商户编号 |
| 平台流水号 | serialNumber | String(32) | 否 | 201702241400010002 | 合利宝-跨境系统生成的唯一交易流水号 |
| 响应码 | errorCode | String(10) | 是 | 0000 | 0000 代表请求成功 |
| 响应信息 | errorMessage | String(200) | 否 | 成功 | 响应信息 错误信息 |
| 响应时间 | current | String(20) | 是 | 2018-04-01 12:00:00 | 格式yyyy-MM-dd HH:mm:ss |
| 二维码 | qrCode | String | 是 | wx:// | 用于生成二维码图片，展示给用户进行扫码支付(下单成功返回) |
代码示例
@Test
public void domesticWxScanPay() {
RemoteService remoteService = new RemoteServiceImpl();
OrderRequestForm appScanPayRequestForm = new OrderRequestForm();
//必填
appScanPayRequestForm.setMerchantNo(LoadPropertiesUtils.getProperty("merchantNo"));
appScanPayRequestForm.setOrderNo("WXPAYSCAN1234567");
appScanPayRequestForm.setProductCode(ProductEnumType.WXPAYSCAN.name());
//订单金额
appScanPayRequestForm.setOrderAmount(new BigDecimal(""));
//商品名称
appScanPayRequestForm.setGoodsName("");
//选填
appScanPayRequestForm.setOrderIp("127.0.0.1");
HeliRequest param = HandleDataUtils.encodeAndSign(appScanPayRequestForm,appScanPayRequestForm.getProductCode(),appScanPayRequestForm.getMerchantNo());
HeliRequest heliRequest = remoteService.postRemoteInvoke(LoadPropertiesUtils.getProperty("domesticWxScanPayUrl"), JSONObject.toJSONString(param), HeliRequest.class);
APPScanPayResponseForm appScanPayResponseForm = HandleDataUtils.decode(heliRequest, APPScanPayResponseForm.class,heliRequest.getProductCode(),heliRequest.getMerchantNo());
logger.info("#####解密后的内容为{}", appScanPayResponseForm);
}
错误码
| 错误码 | 错误码描述 | 解决方案 |
|---|---|---|