接入指南（必读）¶
接入流程 & 接口URL¶
测试环境出口和入口IP为：47.96.196.139，120.55.166.21，47.100.228.212，106.14.147.69，139.224.37.243 ，180.169.69.46 生产环境出口和入口IP为：106.14.51.79,203.107.45.37,139.224.111.237,180.167.97.210,116.228.159.35,112.64.184.162,27.115.110.2,117.144.179.194 注：若贵司系统对外网访问有IP限制，烦请将该IP加入白名单，以确保异步回调能收到。
第一步：下载证书¶
- 开通测试商户后，开发者可以在收到的邮件中，点击链接地址，下载证书。请参考：开发说明&DEMO->加解签&DEMO-> 证书下载操作指引。
- 注：邮件默认发送主联系人，会有3封：分别是含证书下载链接的邮件、含控台地址用户名和商户客户号子账户号等信息的邮件、以及一封含联调进度表和FAQ及证书操作指引的邮件，请联系贵司主联系人邮箱查看。
| 证书 | 用途 |
|---|---|
| **********.pfx | 用于加签 API 的请求参数 |
| **********.cer | 用于解签 API 的返回参数 |
第二步：调用接口URL¶
开发者可以参考 接口调用DEMO 进行对接测试，技术接入前可以浏览：接入指南(必读)-> 接口调用顺序 (适合不同场景) 和 对接过程中常见问题 ，同时请仔细阅读接口文档里的内容。
- 请按 异步回调接收规范 处理异步回调(重要，若不按规范要求可能导致审核不通过)
| 联调测试请求 URL | https://hfpay.testpnr.com/api/接口编号 |
第三步：生产上线¶
- 联调测试完成后，请填好联调进度表发给我司技术审核，审核通过后联系我司商务销售申请开通生产商户客户号。
- 开通生产商户后，请开发者注意修改配置生产证书、生产证书秘钥、商户客户号和接口调用地址。
| 生产请求 URL | https://hfpay.cloudpnr.com/api/接口编号 |
对接过程中常见问题¶
此处提供了在对接汇付接口测试过程中出现的一些常见问题和要求，请仔细阅读。
证书&DEMO问题¶
| 常见问题列表 | 出现该问题的原因 |
|---|---|
| pfx证书从哪获取？ | 请仔细阅读：接入指南（必读）->接入流程-> 第一步下载证书 ,已特别注明证书来源。 |
| 测试环境下载pfx证书连接，点击后收不到验证码？ | 测试环境证书下载不会发送验证码，验证码可输入1111进行下载，生产环境按实际收到的验证码登陆。 |
| pfx证书下载按钮点了没反映？ | 如果是IE内核的浏览器，此时看下internet选项中->内容->证书是否含有NP开头字样的证书，如果有直接按证书下载指引导出即可，其他浏览器可以百度下类似internet选项证书的方式导出。 |
| pfx证书点击下载过期？ | 证书下载链接有时间限制，如过期请联系我司商务销售找中台重新发下。 |
| DEMO程序运行报错加签失败、验签失败、证书非法等 | 1、请确保demo中的商户客户号mer_cust_id和证书及密码是否替换成贵司自己的商户客户号和证书及密码(一个商户号对应一个pfx证书)； |
| 2、检查代码中验签注释部分商户号mer_id是否是固定值100001； | |
| 3、请确保是application/x-www-form-urlencoded方式请求； | |
| 4、jodd-http-5.0.2.jar这个jar包需和jodd-core-5.0.2.jar包配合使用； | |
| 5、调用的pfx和cer证书文件须是绝对路径； | |
| 请求报错：Error occured when checking params | 此报错说明加签前的json串有异常，导致我方服务器解签失败而返回，请检查json串是否有问题。 |
| php的demo命令行执行报错:parameter is null | 请检查证书路径、密码、权限是否有问题，通常原因是没有读证书的权限。 |
| phpDEMO报错Message:cfca_Initialize error:24578 | 初始化失败，请检查下服务器权限。 |
| 加签报错{code=999, message=系统异常,sign=null} | 通常为证书问题，贵司开发者可以重新导入再导出证书，或者在我司技术群咨询。 |
接口问题¶
| 常见问题列表 | 出现该问题的原因 |
|---|---|
| 商户无此接口权限？ | 请联系我司商务销售申请开通该接口权限。 |
| 测试环境个人开户失败？ | 建议用真实身份证开户，身份证号首位请用1-5开头的。 |
| 测试环境短信验证码没收到？ | 测试环境不会发送短信，短信验证码统一为111111。 |
| 快捷绑卡、代扣签约等后台调接口却返回html页面？ | 此类接口，请用页面浏览器form表单方式提交，具体可参考接口文档中每个接口调用方式。 |
| 绑卡返回：MOCK要素未配置，或没有收到异步响应？ | 请用指定的建设银行卡bin测试。建行：01050000 ，其中： |
| 借记卡为：623251000000XXXX，XXXX为0000-9999之间 | |
| 贷记卡为：436748010435XXXX，XXXX为0000-1000之间 | |
| 分账串信息怎么填，分账串信息异常？ | div_detail分账串表示分账对象，填谁，表示钱分给谁，即钱到谁的账户；in_cust_id和in_acct_id表示入谁的账户。 |
| 如果钱入给你们平台，就填你们平台商户客户号和子账号(这个是邮件发的)，如果钱分跟给用户，就填开户接口时返回的user_cust_id和子账号acct_id。 | |
| 报错：支付手续费未配置？ | 此报错说明该交易的手续费没有配置（借记卡支付、贷记卡支付、准贷记卡支付、微信支付宝交易等），请根据合同上的约定联系销售至中台配置费率。 |
| 测试环境首次支付失败？ | 首次支付失败由于手续费金额不足（默认从商户平台扣收）导致的失败，请至商户控台进行网银充值（测试环境只仅支持兴业银行，2元以上），以免不够扣手续费而失败。 |
| 咨询手续费的问题 | 手续费的问题请联系贵司或者我司的商务销售，这是贵司与我司合作签合同或协议时双方约定的。 |