注意事项(重要)
代付API在请求出现异常和(查询/交易)接口文档中标识出状态为“未知”的订单不得直接判断为失败,必须注意以下几点:
1、代付交易付款状态为“未知”时(接口文档附录中已使用红字描述),需使用查询接口查询订单最终状态,只有查询到state状态时才能判定订单状态。其他情况可以继断查询或以最终对账文件中状态为准。
2、return_code(查询/交易)不是订单状态,值为0000只表示受理成功;订单状态以查询接口中state字段为订单状态。
3、文档中(查询/交易)付款状态为未知状态,禁止此订单重发代付交易(除订单查询state有明确的失败的状态以外)。
包括但不限于以上事项,详情请查看代付API接口文档。


问:代付需要传几要素。
答:答对私四要素,身份证,姓名,银行卡,手机号(可传用户在用手机号);对公可不传手机号,身份证号。


问:代付接口异步通知接口是什么?
答:目前只有BF0040001接口有异步通知,订单成功后系统主动推送交易结果;商户需提供一个WebService供我们调用,接口不得有登陆过滤。异步通知接口返回三个参数,商户号(member_id)、终端号(terminal_id)、数据(data_content),接收参数解析XML内的内容,数据格式固定为XML。


问:代付API接口有批量接口?
答:代付API接口是批量接口1批最多5笔交易。


问:代付API并发性能?
答:代付交易接口(BF0040001)【批次接口限制5笔交易】:200-500/s(建议采用,效率高);代付交易拆分接口(BF0040004)【批次拆分接口限制250笔交易】:200-500/s;宝付账户实时交易接口(BF0040007):50~100/s;针对查询可支持并发,建议采用时间迟加查询(如:5s,15s,30s,1m,5m,10,30m,1h……..),同一订单查询间隔10秒以上


问:退款查证接口是什么情况下出现?
答:一笔订单当天银行返回交易成功,在T+1日银行退票的情况,这种情况可使用退款查证接口去查。无论订单是之前那一天的订单,只要是查询当天退回的都可以查到,(如:订单发生在2017年1月1日,而在1月2日银行退回,查询条件只要查1月2日就可以查到该笔退款)


问:代付API中BF0040001和BF0040004接口的区别是什么?
答:以上两接口一批都只能提交5笔交易。BF0040001接口5笔订单中单笔订单不超过限额接口可以通过(如:限额为:49990,当任一订单交易金额大于49990则接口不受理)。BF0040004接口5笔交易中当大于限额的系统进行自动拆分。


问:接口规范中所有报文域以KeyValue的表单方式通过HTTP Post到代付接口?
答:接口文档中3.1(接口公共参数定义)以KeyValue的形式通过HttpClient(POST)请求到接口,其中data_content内是交易数据的密文。


问:代付交易状态查证接口(BF0040002)“trans_batchid宝付批次号”是否可以不填?
答:可以不传宝付批次号,但必传商户订单号(trans_no)。


问:代付接口返回“0002 商户代付证书无效”是什么原因?
答:商户上传公钥不正确。请在宝付(bm.baofoo.com)上传商户公钥,并下载宝付公钥。具体请参看宝付《CFCA安全证书操作流程》和《CFCA数字证书下载操作手册》。


问:代付接口返回“商户未开通代付业务”是什么原因?
答:请联系商务经理,确认代付业务是否处于开通状态。


问:代付接口返回“商户代付业务未绑定{IP},请联系宝付技术支持”是什么原因?
答:代付接口需绑定商户服务器出口IP,如果显示的IP未绑定,需联系商务经理绑定商户服务器出口IP。


问:代付交易返回“代付交易未明,请发起该笔订单查询”应该怎做?
答:可以由于网络原因渠道方异常等情况,需要对该笔订单进行查询。再根据查询接口的结果进行订单后续业务处理。


问:代付查询返回“代付交易查证信息不存在”应该怎么处理。
答:针对这个问题商户不要重发订单,避免造成订单重复发送,必须以对账文件的结果进行判断。


问:代付API中参数return_code可以确定交易成功吗?
答:代付API中return_code是表示交易受理或查询成功,不代表订单的状态成功。订单状态是根据查询接口中的state关健字进行判断的。


问:代付API中对私是否可以不传省市支行信息?
答:对私可以不传省市支行信息,可传空值但接口参数中标签不能缺失,如to_city_name可以<to_city_name></to_city_name>;但对公必传省市支行信息。


问:代付拆分接口中交易总笔数、交易总金额指的是什么?
答:交易总笔数:接口中一次可传最多5条记录,5条记录中超过限额系统会自动进行拆分;交易总金额:接口中一次可传最多5条记录,5条记录的交易金额的总和。


问:代付查询交易返回“主机业务繁忙”
答:同一订单两次查询时间间隔要大于10s。


问:BF0040004拆分接口是如何拆分的?(2020/10)
答:当请求交易中当大于限额(限额请咨询商务)的系统进行自动拆分。拆分后会分成多笔交易,查询时也会返回多笔交易和对应的每一笔交易状态,多笔交易商户订单号相同,宝付批次号相同,宝付订单号不同。