协议支付常见问题汇总

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

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

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

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

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

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

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

答：宝付是实时发送到渠道进行绑卡，同步响应结果。

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

答：目前协议支付接口中无需上送银行编码字段，以下编码可供参考

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

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

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

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

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

答：同一四要素在同一商户下绑卡两次以最后一次绑卡成功的协议号为准，覆盖之前的协议号；

问：同一四要素两次绑卡验证码是谁发送的？

答：首次绑卡、信息发起变更重绑为银行发送，当日重复绑卡为宝付发送，其他情况为银行发送。

问：同一个四要素在不同商户号下分别绑卡协议号是相同的么？

答：在不同商户号下使用同一四要素绑卡协议号不同，不同商户号的协议号互不干扰。

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

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

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

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

问：单日余额不足次数限制15次，是针对卡还是用户呢？

答：相同卡号相同商户号单日余额不足次数为15次，超过15次交易将会限制。

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

答：接口上送参数（unique_code）唯一码是否为明文，该字需要进行AES加密后上送。

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

答：协议支付接口中trans_id（商户订单号）在对账文件中作为对账的重要凭证。该字段商户上送时需要保持唯一。

问：在调用解绑卡接口时结果返回绑定关系不存在是什么原因？

答：解绑返回绑定关系一般是由以下原因导致：

1、解绑时上送的user_id与绑卡时上送的user_id不一致会出现绑定关系不存在，user_id字段可不传。
2、解绑时的上送的协议号不正确或协议号已解绑。

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

答：user_id字段为商户上送，绑卡时user_id为非必传项，可通过绑定关系查询接口查询相关信息。

问：PHP在做（acc_info）账户信息字段姓名超过2个字时会导致加密为空？

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

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

答：首次验证码为银行发送，银行发的短信可能会有次数频率等限制各银行不统最终以银行为准。宝付发的验证码没有次数限制，目前也没有手机号段的限制。

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

答：为上送报文里面的协议号（protocol_no）无法解密可以原因有：

1、需检查上送的数字信封(dgtl_envlp)内上送的AES密码是否正确。
2、加密的方式是否使用的方法是否正确，可参照DEMO方法中的AES加密方法。

问：验证码有效期是多少，多久失效？

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

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

答：需检查分账信息中商户号是否正确，商户号为宝付开通给客户的特约账户，上送不正确会出现异常；其他必要参数缺失也可能会导致系统繁忙。。

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

答：交易和查询不能并发，查询必须是在拿到同步的交易结果后再发起查询，当交易时出现超时，建议延后最少5分钟以上再查询。

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

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

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

答：验签失败一般会有以下原因：

1、如果测试环境测试通过，生产返回验答失败；请检查证书是否正确，是否有完成按证书流程操作参看以下”生产CFCA证书操作流程“部份。
2、验签字符串组装是否缺少组装字段。
3、signature字段是否有上送。
4、交易子类是否有上送错误。
5、检查组装报文的字段是否有传NULL字段的。
生产CFCA证书操作流程如下：
    1、生产环境在CFCA下载证书（下成功后会在浏览器中）
    2、CFCA导出公、私钥，导出私钥时设置的密码作为加密时使用的证书的密码。
    3、把CFCA导出的公钥上传到宝付后台(bm.baofoo.com)，
    4、同时在宝付后台[上传证书页面]下载CFCA宝付解密公钥（点击CFCA证书下载链接）。
    5、最后把导出私钥及设置的密码和下载的CFCA宝付解密的公钥配到生产环境。

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

答：私钥密码是商户自己在导出私钥时设置的,私钥密码错误无法正确读取到证书内容，请确认导出时设置的私钥密码。

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

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

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

答：该错误表示交易失败次数超限，涉及风险规目前不对外，具体可联系客户进行沟通协调。

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

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

问：协议支付存量签约（协议号匹配）接口交易类型（txn_type=84、85）返回的协议号是密文吗？如何获取到明文协议号？

答：返回的协议号字段是密文，首先返回的dgtl_envlp使用公钥解密，获取到AES解密的密码，再对protocol_no字段做AES解密，对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.2及以上版本。

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

答：原因一般有:

1、银行不支持；
2、终端号错误；
3、产品未开通；
4、产品未设置再终端号的上；

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

答：宝付支持的银行并且商户开通该银行的绑卡/支付功能才能进行绑卡，不支持的银行卡签约会返回未开通此产品之类的报错信息。

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

答：出现交易类型不存在有以下原因：

1. 参数未请求到服务端，打开接口地址就会提示：交易类型不存在，请排查请求方法是否正确。
2. 请求的Content-type要为“application/x-www-form-urlencoded”。

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

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

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

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

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

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

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

答：实时返回有所有状态，只有终态才会有异步通知。异步通知是宝付将交易结果主动推送到交易上送的接收地址中。

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

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