协议支付常见问题汇总

问：宝付同一个人绑卡数量有限制吗？

答：绑卡没有限制，同一个人可以绑定多张不同卡。

问：宝付系统内不同商户，可以共用同一个用户的签约协议吗？

答：默认情况下不同商户号下的协议号不能通用，但是可以使用协议号共享，协议号共享需联系商户经理走相关流程。

问：如果客户在银行的手机号信息变更了，那需要客户重新绑卡吗？

答：正常情况手机号在宝付端发生过变更，所有的客户都需要使用新的手机号进行绑卡。在银行端发生个变更，如果在宝付没有重新绑卡的情况，我们将会把协议号发送给银行由银行进行判断。

问：绑卡之前有什么多线程或者队列之类的排队操作吗？

答：宝付是实时发送到渠道进行绑卡。

问：请问你们的协议支付的银行编码-名称的表格有么？

问：协议支付接口版本号用4.0.0.0还是4.0.0.7？

答：需根据具体对接业务使用的对接接口中的版本号即可。

问：协议支付是不是调用文档2.2.3之前需要调用文档2.2.1和2.2.2接口绑卡？

答：是的，调用协议支付时必须先进绑卡操作。

问：同一个四要素在1个商户号下面绑卡绑两次会怎么样？ 两次绑卡验证码分别是谁发送的？

答：同一四要素在同一商户下绑卡两次以最后一次绑卡成功为准，之前协议号失效；首次绑卡、信息发起变更重绑为银行发送，其他为宝付。

问：同一个四要素在2个商户号下面分别绑卡会怎么样？

答：协议号不同，商户号互不干扰。

问：同一个四要素在2个商户号下面绑卡，这2个商户号做过协议号互通（共享），会怎么样？

答：两商户协议号共享，2个商户号可以使用对方的协议号进行扣款，但不默认情况下能查询对方的协议号，可以使用共享协议号查询接口。协议号共享需联系商户经理走相关流程。

问：协议支付判断交易是否成功，可以通过错误码这个映射关系吗？

答：不可以，协议支付只能通过接口中的答码判断订单状态（S为成功、F为失败、I为处理中、FF为异常不做订单状态），不再区分错误码。

问：单日余额不足次数限制3次，是针对同张卡还是同个用户呀？

答：单日余额不足次数限制3次，是针对卡号。

问：协议支付确认绑卡联调时返回报文中密文解析失败:unique_code？

答：上送过来的唯一码是否明文，需要对唯一码做下AES加密。

问：我们需要保存一下宝付的唯一流水号，我保存哪个比较好呢? 不知道宝付对账的文件中宝付放入的是msg_id还是order_id? 一般后台查询用msg_id还是order_id？

答：宝付对账文件中会有trans_id商户订单号。这个就是唯一的订单号。

问：测试环境联调解绑卡接口时结果都返回绑定关系不存在？

答：解绑时的user_id跟绑卡时的user_id不一致会出现绑定关系不存在，解绑时的user_id必须跟绑卡时的一致或者送空才能解绑成功。

问：协议支付预签约，入参user_id从哪获取？

答：user_id是商户上送，绑卡时user_id是选填项，如果不需要，可以送空。

问：php版demo测试时账户信息字段姓名超过2个字时会导致加密为空？

答：使用的php版本7.0，加密方法中填充方式使用OPENSSL_RAW_DATA 就可以。

问：宝付对于协议支付预绑卡，下发验证码是否有次数限制，还有是否对手机号号段是否有限制？

答：首次验证码为银行发送，短信次数银行发的可能有限制，宝付发的短信没有次数限制，手机号目前没有号段的限制。

问：协议支付直接支付接口返回biz_resp_msg=报文中密文解析失败:protocol_no。

答：解密请求报文里面的协议号无法解密，可能加密的不正确，请参照DEMO方法使用AES秘钥加密。

问：预绑卡发的验证码多久失效？

答：正常银行发的短信验证码1-10分钟左右，各家银行不统一最终以银行为准；宝付发的短信验证码30分钟。

问：协议支付组合支付返回‘系统繁忙’。

答：分账信息中商户号上送超过长度会导致异常，不能随意传商户号信息；其他必要参数缺失也可能会导致系统繁忙。。

问：订单查询返回“订单号不存在”，可是订单号没问题。

答：交易和查询不能并发，查询必须是在拿到同步的交易结果后再发起查询。

问：在什么情况下，会出现：订单已过期，请使用新的订单号发起。

答：绑卡和交易有效期为30分钟，必须在30分钟内完成绑卡或交易操作，否则就会返回订单已过期；预签约唯一码使用过也会提示订单号过期。

问：生产环境调试协议支付接口返回验签失败。

答：1、如果测试环境测试通过，生产返回验答失败；请检查证书是否正确，证书流程是否正确。生产环境:导出公、私钥，导出私钥时设置的密码作为加密时使用的证书的密码，把公钥上传到宝付后台(bm.baofoo.com)，同时在宝付后台下载CFCA宝付解密公钥。把导出私钥及设置的密码和下载的CFCA宝付解密的公钥配到生产环境.
2、验签字符串组装是否缺少组装字段。
3、signature字段是否有上送。
4、交易子类是否有上送错误。
5、检查组装报文的字段是否有传NULL字段的。

问：正式环境报私钥读取异常【密码和证书不匹配】！是什么原因？

答：私钥密码是商户自己在浏览器导出私钥时设置的，私钥密码错误是无法读取到私钥；请确认导出时设置的私钥密码。

问：用共享协议查询接口查询不到协议号，主商户号说绑卡成功了的，为什么我们查不到协议号？

答：必须用主商户绑卡时使用的相同四要素去查询，才可以返回协议号。

问：接口返回BF00415 该卡当日失败次数超限，请次日再试，每天的失败次数有限制吗？失败次数限制可以调整吗？

答：单日余额不足失败次数有限制，一般是三次，需要调整次数上限需联系商户经理处理。

问：A和B公司配置了协议共享关系之后，A公司绑卡的协议号，共享给B公司，B公司发起代扣，代扣也是扣到B公司的账户对吗？

答：是的，哪个商户号发起的扣款，扣款就会进入到对应的商户号。

问：撞库返回的协议号是密文吗？如何获取到明文协议号？

答：返回的协议号字段是密文，需要先对该字段做AES解密，再做base64解码才能得到明文协议号。

问：协议支付产品的直接支付接口在返回交易失败后，是否会返回交易成功时间这个字段？

答：交易成功时间只有在交易成功后返回，交易失败不返回。

问：预绑卡uniquecode的有效期是多久？

答：预绑卡唯一码有效期30分钟，超时后需要重新发起预绑卡接口获取新的唯一码。

问：返回的数据格式是Json还是XML？

答：不是json也不是xml，返回格式为key1=value1&key2=value2&key3=value3…。

问：确认绑卡那个接口返回的resp_code有没有可能是I：交易中？

答：可能会出现，可以使用查绑接口去查询；如果不存在可以重新确认。正常情况下协议绑卡一般不会出现处理中的状态，正常情况只有失败、成功状态。

问：你们协议支付，能支持一个用户一次签约两个商户么？

答：不同商户都需要调绑卡接口，不能同步签约两个商户，可以使用协议号共享。

问：发起扣款申请发出后，间隔多久能通过查询接口查到结果？

答：正常发起扣款后同步响应会有支付结果，商户可以根据同步返回结果，去调查询接口。

问：确认绑卡返回“订单已过期，请使用新的订单号发起交易”。

答：签约唯一码已使用过，且绑卡成功，需要重新生成一个新唯一码进行绑卡；预签约唯一码超过了有效期也会提示订单号过期。

问：协议支付绑卡查询接口，是否只能查询指定商户的绑卡结果？如果要查询其他商户号下的绑定记录如何实现？

答：协议支付绑卡查询只能查询发起商户下的绑卡结果；如果要查询其他商户号的绑定记录可以使用协议共享可以查询共享方的协议号，前提需要联系商户经理走相关流程开通协议共享。

问：如何验证签约协议号是否有效？

答：正常在宝付只要用户信息不变，在银行没有终止授权或解绑协议号一致有效。如果没有记录协议号可以通过协议号查询接口查得。

问：协议支付可以用应答码判断支付订单状态吗？

答：可以用应答码判断订单状态（S为成功、F为失败、I为处理中、FF为异常）FF不能为订单状态；处理中的订单不能直接认为失败，需要调查询接口查询到终态。

问：协议支付，支付短信功能如何申请？

答：如果使用的是预支付+确认支付，支付短信默认不发送，生产环境需要联系商户经理申请配置，配置了就会发送的短信。

问：返回报文交易要素格式错误是什么原因？

答：1、数字信封格式是否正确，正确格式为01|密钥。
2、加密数字信封的公钥不是宝付公钥（dgtl_envlp错）。

问：直接支付收不到异步回调。

答：1、检查是否有上送地址，地址是否正确。
2、接收回调地址是否能在外网访问。
3、网络是否有设置黑白名单，是否需要把宝付出口IP加入白名单。

问：同一信息签约两次后，会有两个签约协议号，这两个协议号都可以扣款吗？

答：同一信息两次签约以最后一次返回协议号为准，之前协议号失效。

问：绑卡成功后没有解绑还可以继续重新绑卡？

答：绑卡可以重复绑,重复绑卡会生成新的签约号，支付需使用最新的签约号

问：绑卡成功后如果四要素其中一个要素变更重新绑卡，这种情况只能先解绑再重新绑卡吧?

答：如果是手机号发起变更，可以直接重新发起绑卡；如果是身份信息发起变更联系我们处理。

问：协议支付接口连不上，请求返回Coennection Reset。

答：协议支付请求需要JDK1.7及以上版本，TLS协议需要1.1及以上版本。

问：协议支付，支付时提示“该商户未开通此产品”

答：原因一般有：1、银行不支持，2、终端号错误，3、产品未开通、4、产品未设置再终端号的上。

问：绑卡会校验银行卡所属银行吗？

答：只有宝付支持的银行才能绑卡成功，不支持的银行卡签约会返回未开通此产品之类的报错信息。

问：请求返回BF00436交易类型不存在？

答：1. 请求参数没有发送过来，打开接口地址就会提示：交易类型不存在。2. 请求的Content-type要为“application/x-www-form-urlencoded”格式。

问：接口返回BF00424（持卡人身份信息已过期）这个代码是什么原因？

答：持卡人身份证已过期，指是用户在银行办卡时预留的证件信息已过期，并不是他的当前证件过期；需要去发卡行进行更新。

问：协议支付查询存量签约记录接口，假如我们两个商编（A、B）都开通了撞库权限，A商户通过存量绑卡接口查询的协议，B商户也可以用同一个协议来扣款吗?

答：没有开通协议共享的情况下，不可以。

问：商户订单号的长度是多少？文档上写的是50位。

答：建议商户订单号不要过长，订单号长度保持在30位以内。

问：直接支付接口实时返回的和异步通知的有什么区别？

答：实时返回有处理中状态，异步只有成功或者失败。异步通知是宝付将交易结果主动告诉商户通过你们交易上送的接收地址。

问：预支付和直接支付区别在哪？

答：预支付+确认支付组合，可以选择发送短信验证码，使用场景不一样。而直接支付则没有这个场景的应用。