常见问题¶

商户签约¶

合作的材料

协议及公司资质：协议（双方盖章）、五证扫描件（加盖商户红色公章）、ICP 备案（需包含网址域名）、App 产品截图（App 首页、尾页、产品详情页、支付页）、特殊行业许可（票务、游戏、直播、交易所、艺术品、典当、基金、保险）
经营照片（地址照片、门头照片、经营照片）；
表单（《商户信息采集表》、《商户评分表》）；
股东相关资质材料；

公司资质

公司五证：营业执照，组织机构代码证，税务登记证，开户许可证，法人身份证；
若三证合一，则提供营业执照，开户许可证，法人身份证；
公司必须为中国大陆注册的公司；

企业五证

营业执照、组织机构代码证、税务登记证、开户许可证、法人身份证；
若三证合一，可直接用三证合一的营业执照代替组织机构代码证和税务登记证；
五证需为在证件有效期内的最新版本，且信息统一；

三证合一

“三证合一”，就是将企业依次申请的工商营业执照、组织机构代码证和税务登记证三证合为一证，提高市场准入效率；“一照一码”则是在此基础上更进一步，通过“一口受理、并联审批、信息共享、结果互认”，实现由一个部门核发加载统一社会信用代码的营业执照。

三证合一证件示例：

营业执照右上角标有“统一社会信用代码”字样，或标有“注册号”、“税务登记证号”和“组织机构代码证号”字样的均为三证合一营业执照。

合作 APP、PC、H5 支付分别需要提供的产品资料有哪些

APP 支付：需 APP 产品截图，即 APP 首页、尾页、产品详情页、支付页；
PC 端网页支付：需保证 PC 端网页已进行过 ICP 备案，且可以正常访问，并有一定的支付场景；
H5 网页支付：需保证网址已进行过 ICP 备案，且可以正常访问，并有一定的支付场景；

ICP 备案

ICP 备案是指在国家工业和信息化部进行互联网信息服务备案。

如何查询 ICP 备案信息

ICP 备案可以自主通过备案网站在线备案。请登录国家工信部官网进项查看。网址：http://www.miitbeian.gov.cn/publish/query/indexFirst.action

资金结算

目前商户的收款资金主要通过提现、结算方式结算至商户对公银行账户。申请时可自行选择手动提现或自动结算。

企业开户，返回执照类型和执照号不匹配，怎么办

普通营业执照企业，需要填营业执照、税务登记、组织机构代码；三证合一企业，需要填统一社会信用代码。

证书问题¶

pfx/cer 证书从哪获取

pfx 证书一般是邮箱发送至主联系人（上线资料都是通过邮件发送，若未收到邮件，请检查下垃圾箱），邮件中会有一个证书下载链接，该链接下载有效期为8小时，请尽快下载，可以按照邮件中的证书下载指引下载。

pfx 和 cer 证书的区别：pfx 证书加信用使用，cer 证书验签信用使用。

测试环境下载 pfx 证书连接，点击后收不到验证码，怎么办

测试环境不会发送短信，测试环境证书下载页面验证码 1111，生产环境按实际收到的验证码登陆。

pfx 证书下载按钮点了没反应，怎么办

如果是IE内核的浏览器，此时看下 internet 选项中内容证书是否含有 NP+ 商户号字样的证书，如果有直接按证书下载指引导出即可，其他浏览器可以百度下类似 internet 选项证书的方式导出。建议使用浏览器以及使用版本（产品确定）。

pfx 证书点击下载，提示证书过期，怎么办

证书下载有时间限制，有效期为 8 小时，如过期请联系对接人（运维技术人员或销售人员）重新发送。

demo 问题¶

运行 demo 出错怎么解决

请更换 demo 中的商户客户号（mer_cust_id）、证书、公钥等信息，更新成商户自己的即可。

php 的 demo 验签失败怎么解决

php 的 demo 中的 checkvalue 需做两次 base64，TUlJ 开头才对。

php 的 demo 运行 socket 通讯失败怎么解决

请先运行 run-socket.bat（windows 环境下）、run-socket.sh（linux 环境下）脚本，确保 run-socket.bat （windows 环境下）、run-socket.sh(linux 环境下)是开启运行状态，同时确保通讯端口未被占用。

php 的 demo 运行失怎么解决败

需要安装 java 环境（JDK1.7 以上）。

demo 运行报错证书非法怎么解决

请确保 demo 中的商户客户号 mer_cust_id 是否替换成商户自己的商户客户号(一个商户号对应一个 pfx 证书)；
请确保为测试环境；
检查代码中验签注释部分商户号 mer_id 是否是固定值 100001；

接口加签验签参数问题¶

接口文档中入账客户号（in_cust_id）入账账号（in_acct_id）从哪获取

in 表示入的意思，cust_id 和 acct_id 都是开户接口返回的（比如 user_cust_id），快捷支付、代扣支付交易入账客户号可以固定填商户的账号和客户号（此信息也有邮件发送到您上线留的主联系人邮箱，通过开户邮件返回）。

报请求参数非法，如何解决

检查参数及其格式是否正确，如金额必须加 2 位小数；数字括号必须为半角等。

报签名/验签失败，如何解决

检查签名 encode 是否出错，如 url 在签名前不 encode，传参才需要 encode，数字括号必须为半角，加签的 checkvalue 是否为 TUlJ 开头的字符，是否漏了参数等。

报商户无此接口权限，如何解决

找销售对接人申请开通该接口。

报商户调用接口风险受限，如何解决

该报错为被我司风控拦截，可以找销售对接人联系风控处理。如果错误码为 XXX80X（前三位标示接口名称 CMDID，后三位标示错误码，通常错误码为 80 开头的均为风控拦截）。

企业开户，快捷绑卡，代扣签约等后台调接口返回 html 页面，如何解决

此类接口，需用页面浏览器方式调用，具体可参考接口文档中每个接口调用方式是前台页面调用或者是后台接口调用。

开户失败如何解决

建议用真实身份证开户，身份证号首位请用1-5开头的，符合真实身份证的号码规则。

同步异步中文返回解签乱码，如何解决

同步的 json 和 post 数据，都是需要用 utf-8 编码做一次 urldecode，异步的，需要设置 http 编码为 utf-8，然后直接取值。

异步回调问题¶

异步应答先收到失败后收到成功，如何处理

由于网络不稳定原因，存在先失败后成功的异步应答，请按成功的处理，具体参考接口文档异步应答接收规范。

收不到异步应答，怎么办

请检查异步应答地址 bg_ret_url 是否外网可以访问。

测试环境绑卡/支付的短信验证码没收到，怎么办

测试环境不会发送短信，绑卡/支付的短信验证码统一为 111111。

测试环境快捷绑卡、取现绑卡、代扣签约同步返回“已受理”，没有收到异步响应，或者收到“MOCK要素未配置”，或者直接返回交易失败怎么处理

借记卡：请用指定卡 bin 测试。建行：01050000

623251000000XXXX，XXXX为 0000-1999 之间。

贷记卡：请用指定卡 bin 测试。建行：01050000

4367480104350000–4367480104351000 之间。

接口业务逻辑问题¶

快捷交易可以调哪些接口

我们提供多种快捷支付方式，商户可以根据自身需要来调接口，需要用到的接口如下：

个人开户接口一阶段绑卡签约短信发送接口快捷绑卡一阶段快捷支付短信发送接口卡快捷支付（有页面有短信）；
快捷支付WEB版接口（开户绑卡支付三合一接口，有页面有短信，PC版）；
快捷支付APP版接口（开户绑卡支付三合一接口，有页面有短信，移动端）；
个人开户接口-快捷支付统合版一阶段-快捷支付统合版二阶段(可以申请关闭页面，有短信);
前台快捷绑卡代开户接口（cmd_id=816，有页面）-后台快捷-两段式快捷支付接口（cmd_id=850，后台，无页面）；
后台快捷绑卡代开户接口（cmd_id=812，后台，无页面）-后台快捷-两段式快捷支付接口（cmd_id=850，后台，无页面）；

2、分账串的分账对象是谁

分账目前只能分账给其他用户，比如：A的银行卡快捷支付不能分账给A在汇付开立的虚拟账户，只能分账给商户或者该商户下的其他用户的虚拟账户。

代扣可以调哪些接口

我们提供消费分期代扣和非消费分期代扣，商户可以根据自身需要来调接口，需要用到的接口如下：

消费分期订单信息录入接口-个人开户接口-消费分期代扣签约绑卡接口-代扣支付接口；
个人开户接口-非消费分期代扣签约绑卡接口-代扣支付接口；
消费分期订单信息录入接口（可申请非消费代扣，那么可以不用调这个接口）-前台代扣绑卡代开户接口（cmd_id=817，有页面）-充值代扣接口（cmd_id=849，后台，无页面）；
消费分期订单信息录入接口（可申请非消费代扣，那么可以不用调这个接口）-后台消费分期代扣绑卡代开户接口（cmd_id=806，后台，无页面）-充值代扣接口（cmd_id=849，后台，无页面）；
单笔代扣（裸扣）接口；（后台，无页面，无需开户绑卡、需找商务进行资质申请）；
批量代扣（裸扣）接口；（后台，无页面，无需开户绑卡、需找商务进行资质申请）；

取现/代发/代付可以调哪些接口

对于用户主动取现形式的调用方式：

个人开户接口绑卡取现卡接口-转账接口（如果快捷支付、网银支付、代扣支付支付全部分账给商户的情况下，需调转账接口）取现接口（注意：为了避免转账成功，取现失败的情况，建议其中增加余额判断的方式，以防用户下次取现多转一笔钱）。

对于商户主动代发/代付方式调用方式（代付就是代发，叫法不同而已），可以用代发接口：

直接调代发接口，（可以不用开户，直接发钱到用户银行卡；出账客户号和出账子账号表示是从哪个用户的虚拟账户出账，确保虚拟账户有钱）。

网银支付功能哪些接口

我们提供两种网银支付方式，一种是用户不需要开户直接网银支付，一种是已开户的用户网银支付，如下：

个人开户接口-网银支付接口（user_cust_id需要传）；
网银支付接口（user_cust_id 不用传）；
后台网银充值接口；

解绑用哪些接口

短信发送接口-银行卡解绑接口。

快捷支付问题¶

快捷支付用户银行绑卡失败，怎么办

情况一：提示预留信息不正确，但用户都到银行柜台核实了预留信息没问题，网银手机银行功能都已开通。

排查原因：手机号与银行预留的手机号不一致。要确保开户、开通网银、开通网上支付以及开通的其他业务预留的手机号均是一致的。

处理办法：详情可咨询对应银行的官方客服热线，持卡人也可到银行柜面、银行自助终端、网银开通银联无卡支付业务的页面，核实与个人客户基本资料中预留手机号码是否一致。

情况二：在验证环节提示失败，需要到银联申请开通“银行在线支付功能”。

处理办法：根据人行对银联的相关要求，有五家银行（平安、邮储、渤海、浦发、上海银行）的个人网银需要申请开通银行“在线支付功能”后，方可绑卡成功，否则在绑卡的验证环节会提示失败。

可拨打银联客服电话 95516，按照语音提示输入银行卡号，输入卡验证信息，直至提示开通在线银联支付签约成功。

在支付时，系统提示余额不足，持卡人账户有余额，怎么办

这种情况一般主要是发卡方为了保护该银行账户的安全，防止有人恶意盗刷，当卡支付余额不足（支付金额大于账户余额）且操作支付次数超过两次后，将暂时冻结该帐户网上银行支付，次日自动解冻。系统会提示“请隔日再试”。

处理办法：

在支付时，若系统提示“余额不足”，请持卡人确认银行账户余额足额，再做第二次支付；
在支付时，若系统提示“余额不足”，也可建议持卡人换张银行卡支付；

交易问题¶

测试环境首次做快捷支付失败，怎么办

请至商户控台进行网银充值（测试环境只支持兴业银行，建议 2 元以上），以免不够扣手续费而失败；

操作步骤：登录商户控台商户账户管理账户充值选择基本户输入金额下一；

商户请求短信验证码接口，提示“短信发送过于频繁，怎么解决

每个接口短信次数为 10 次，如果超过 10 次或连续两次请求间隔时间在 1 分钟以内，均会报错“短信发送过于频繁”，请次日再操作（一般是绑卡和快捷支付）。

绑卡失败，怎么办

平安、浦发、上海、渤海、邮储等银行，需要先完成银联在线支付签约才可以绑卡（绑卡的时候，在银行卡下面出现）。可拨打银联客服电话 95516，按照语音提示输入银行卡号，输入卡验证信息，直至提示开通在线银联支付签约成功。

绑卡失败，持卡人身份信息或手机号输入不正确，验证失败，怎么办

中行绑卡失败的情况：请客户咨询银行信息是否正确，特别注意，手机号只能预留在移动电话一栏，若预留在家庭电话则会出错；
工行绑卡失败的情况：请客户确认手机信息必须在工行柜面预留，其他渠道（如自助网银预留等）将会导致失败；

取现失败，但是商户金额变少了，用户也并有收到钱，怎么办

请核实贵司取现这个动作是否是转账成功后立即调取现接口的情况，此类问题是由于转账成功，但是取现失败，金额已转至用户账户，所以商户账户金额变少，针对该情况，建议增加调用余额查询接口判断用户是否有余额，再做转账操作。

交易失败客户收到扣款短息，怎么办

交易在银联与发卡行侧发生超时。交易明确为失败交易，不参加资金清算。资金目前在发卡行。发卡银行在与银联对账后，对资金进行退款处理。

现在客户反馈的情况，有可能是2种情况：

该笔交易已经冲正，客户只关注到扣款未留意到已经冲正的情况；
该笔交易还在发卡行内部处理流程中，如果发卡行处理时效慢，可以让客户联系发卡行；

T0 取现/代发收不到异步应答，如何处理

生产环境主要看银行端，一般需要 T+3 更新。成功应答有些有有些没有，失败了会有异步应答。