快捷H5
| 测试请求地址 | https://cbtrxtest.helipay.com/cbtrx/rest/pay/quickH5Apply |
| 请求地址 | https://cbptrx.helipay.com/cbtrx/rest/pay/quickH5Apply |
| 提交方式 | 采用POST方法提交,requestbody传值 Content-Type=[application/json;charset=UTF-8] |
| 签名算法 | UTF-8字符编码 SHA256签名 AES加密 |
| 名称 | 参数 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|---|
| 产品编码 | productCode | String(20) | 是 | QUICKPAY | |
| 商户订单号 | orderNo | String(64) | 是 | p_20170302185347 | |
| 商户编号 | merchantNo | String(10) | 是 | Me10000002 | 合利宝-跨境系统分配的商户编号 |
| 用户姓名 | memberName | String(10) | 是 | 张三 | |
| 用户身份证号 | memberID | String(18) | 是 | 110101200001012999 | |
| 用户手机号 | memberMobile | String(20) | 是 | 13701234567 | |
| 订单金额 | orderAmount | Number(10.2) | 是 | 0.01 | 单位：元 |
| 币种 | currency | String(6) | 是 | CNY | 默认为CNY |
| 商品名称 | goodsName | String(400) | 是 | 保时捷 | |
| 证件类型 | idCardType | String(20) | 是 | IDCARD | |
| 用户ID | userId | String(64) | 是 | ||
| 下单IP | orderIp | String(20) | 是 | 127.0.0.1 | |
| 服务器通知回调地址 | serverCallbackUrl | String(100) | 是 | www.baidu.com | 通知商户地址 |
| 银行卡号 | cardNo | String(64) | 否 | ||
| 信用卡有效期年份 | expireYear | String(20) | 否 | ||
| 信用卡有效期月份 | expireMonth | String(20) | 否 | ||
| cvv2 | cvv2 | String(20) | 否 | ||
| 有效期单位 | periodUnit | String(20) | 否 | MINUTE | |
| 有效期 | period | String(20) | 否 | 30 | |
| 前台页面通知地址 | callbackUrl | String(100) | 否 | http://h5.helipay.com/success.php | |
| 是否走有积分通道 | isIntegral | String(20) | 否 | true | 为空默认走无积分通道 true:有积分 false：无积分 |
| 备注 | desc | String(40) | 否 | ||
| 平台商户编号 | platMerchantNo | String(10) | 否 | 如下说明 | 电商平台商户所属的平台商编号 |
| 分账请求参数明细 | shareList | List(100) | 否 | 如下说明 | 若商户开通分账产品，且本次交易需要分账，则此参数必填 |
| 名称 | 参数 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|---|
| 排序参数 | index | Integer | 是 | 1 | 用于交易加密参数排序，不能重复 |
| 分账账户编号 | shareMerchantNo | String(10) | 是 | Me10000002 | |
| 分账金额 | shareAmount | Number(10.2) | 是 | 0.01 | 单位：元 所有明细分账金额相加必须等于交易金额 主账户分账金额必须大于交易手续费 |
| 名称 | 参数 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|---|
| 产品编码 | productCode | String(20) | 是 | QUICKPAY | |
| 商户订单号 | orderNo | String(64) | 是 | p_20170302185347 | |
| 商户编号 | merchantNo | String(10) | 是 | Me10000002 | 合利宝-跨境系统分配的商户编号 |
| 跳转HTML | redirectUrl | 是 | 对应跳转地址 | ||
| 返回码 | retCode | String(10) | 是 | 0000 | 0000 代表请求成功 |
| 返回信息 | retMessage | String(200) | 否 | 成功 | 响应信息 错误信息 |
@Test
public void testQuickH5() throws Exception {
QuickH5PayRequestForm quickH5PayRequestForm = new QuickH5PayRequestForm();
quickH5PayRequestForm.setMerchantNo("Me10000018");
quickH5PayRequestForm.setOrderNo("quickH5pay00000001");
quickH5PayRequestForm.setProductCode("QUICKPAY");
quickH5PayRequestForm.setGoodsName("bnnbbnnnbbnnnbnb");
quickH5PayRequestForm.setOrderAmount(new BigDecimal(0.12));
quickH5PayRequestForm.setCurrency(String.valueOf(Currency.CNY));
quickH5PayRequestForm.setOrderIp("1227.0.0.1");
quickH5PayRequestForm.setServerCallbackUrl("http://www.helipay/server.html");
quickH5PayRequestForm.setUserId("Me10000018");
quickH5PayRequestForm.setPeriod("");
quickH5PayRequestForm.setPeriodUnit("");
quickH5PayRequestForm.setMemberID("");
quickH5PayRequestForm.setMemberName("");
quickH5PayRequestForm.setIdCardType("");
quickH5PayRequestForm.setCardNo("");
quickH5PayRequestForm.setExpireMonth("");
quickH5PayRequestForm.setExpireMonth("");
quickH5PayRequestForm.setCvv2("");
quickH5PayRequestForm.setMemberMobile("12122121212");
quickH5PayRequestForm.setCallbackUrl("");
quickH5PayRequestForm.setIsIntegral("true");
quickH5PayRequestForm.setDesc("");
payTest("/rest/pay/quickH5Apply", quickH5PayRequestForm, QuickH5PayOrderResponseForm.class);
}
| 错误码 | 错误码描述 | 解决方案 |
|---|---|---|