...
.....
帮助中心
常见问题自助答疑

常用问题

Q:商户如何登录?
A:商户可通过酷宝支付官网,网址: http://www.yacolpay.com进入商户后台,输入商户号、登录密码、验证码点击登录,或者可直接访问商户后台,网址:http://merchant.yacolpay.com。
Q:忘记登录密码怎么办?
A:您可以通过自助找回功能找回登录密码,在登录框,点击“忘记密码”,输入商户号、验证码等操作,通过邮箱找回。
Q:如何修改登录密码?
A:登录商户后台系统,点击【安全中心】中【修改登录密码】,输入原登录密码和新登录密码,进行修改。
Q:如何修改商户基本信息?
A:如需修改商户基本信息,请直接与对应的客户经理联系,提供相关信息资质进行修改。

快捷支付
Q:为什么订单会交易关闭?
A:交易关闭说明订单失败了,一笔订单默认有效期为24小时,如果过了有效期,订单就失败了,状态就是trade_closed。
Q:商户收到同步错误返回“卡号与银行不匹配”?
A:因卡bin校验失败,请用户检查卡号与银行卡是否匹配,如:如工商银行的银行卡,将银行编码误传为BOC。
Q:商户交易成功,但是没有收到系统异步通知?
A:1:是否传送异步通知地址,2:传送的异步通知地址是否可以正常访问。
Q:快捷信用卡支付,提示鉴权失败?
A:我们的渠道校验银行卡6要素,请核对6要素是否正确。
Q:邮政卡支付1元交易失败,返回商户“F0314交易拒绝?
A:邮储银行卡需要开通在线支付
在线支付开通的有三种方式:
1、个人网银
2、银行柜面(银行可能成为银联无卡支付业务)
3、相关银联网址
https://www.95516.com/static/union/pages/card/openFirst.html?entry=openPay
Q:快捷支付返回商户“证件号码不正确或与银行绑定不符”,四要素验证通过,为什么支付失败?
A:因为鉴权与支付用渠道不一致,鉴权可以通过,但是支付渠道可能没有通过,所以就会出现,鉴权成功支付失败的情况,但是鉴权失败支付一定失败。
Q:使用某张银行卡交易1000元,返回交易金额超限?
A:交易金额超限分为单笔和单日,请核对用户在我司的交易是否超过单笔或单日限额,如未超过,请与用户核实该卡是否在其他渠道使用过导致单日交易金额超限。
Q:卡要素支付推进模式返回商户“推进失败”?
A:请关注errorMessage,该信息展示推进失败的具体原因。
Q:调用绑定银行卡接口时,报“同平台银行卡可绑定身份证数超限”?
A:因逻辑是以身份证绑定为维度,1张身份证可以绑多张银行卡,一个平台只能绑一张身份证。

网银支付
Q:交易已经成功,但是账户中没有钱?
A:酷宝支付T1结算时间为 T+1日14:00结算。成功结算后才会在基本户中查询到余额。
Q:用户已付款,订单还是处理中?
A:先请用户提供扣款凭证。由商户核实凭证与订单是否一致。如果均一致请联系酷宝支付运营。酷宝支付运营会与上游反馈查明问题。
Q:如何退款?
A:在商户后台点击申请退款,系统会自动处理退款订单。预计1-3个工作日原路退回。
Q:订单报错:支付方式或银行不支持?
A:检查该笔交易的银行是否在银行的支持列表中,检查传的银行简码是否与交易订单中卡的简码是否一致。如以上均正确,请联系酷宝支付运营。
Q:订单交易关闭,但是用户已经付款?
A:请联系酷宝支付运营。由于酷宝支付订单的有效期为24h,银行超过24h未返回交易状态,需酷宝支付运营和上游联系。

协议支付
Q:交易状态都代表什么?
A:交易结束:一笔交易的最终状态,即交易成功,钱已结算到商户的账户中
付款成功:用户已完成付款,T1的商户可以判定为这笔交易已经成功,第二天结算后会变为交易结束
交易关闭:这笔交易已经失败。酷宝支付默认订单24h有效期,超过有效期后交易关闭。
Q:商户收到同步错误返回“卡号与银行不匹配”?
A:因卡bin校验失败,请用户检查卡号与银行卡是否匹配,如:如工商银行的银行卡,将银行编码误传为BOC。
Q:商户交易成功,但是没有收到系统异步通知?
A:请检查异步通知是否上传,上传的异步通知地址是否可以正常访问。
Q:鉴权报错:鉴权绑卡失败BANK_INFO_VERIFY_FAILED,验证信息与真实信息不一致?
A:请检查用户的卡信息是否填写有误。如核实无误请联系酷宝支付运营。

代付
Q:代付支持的银行列表和限额?
A:酷宝支付的代付业务基本支持所有银行,工作日9:30-16:00支持大额出款即5万元以上。5万元以下支持7*24小时出款。注:垫资代付每日22:00-0:30进行维护,不可以发送交易。
Q:代付订单报卡bin不匹配?
A:卡bin校验失败,请检查卡号与银行卡是否匹配。例如出款目标为工商银行的卡,工商银行简码为ICBC,商户上传的银行简码为CCB(建行)。
Q:入金为T1结算的商户,进行代付失败。返回信息为其他失败?
A:请检查卡信息是否上传正确,如上传有误请修改信息,重新发起代付即可。
Q:什么是退票?
A:用户银行卡信息有误,银行渠道出款成功。发卡行检查到用户信息有误,拒绝收款就会产生退票。
Q:退票的订单如何处理?
A:酷宝支付与上游对账完毕,发现问题订单做退票处理。资金会在1个工作日内退回到商户账户中。
Q:代付订单报错:路由异常无可用渠道?
A:请联系酷宝支付运营。
Q:商户调代付接口报“校验失败:会员账户不能为空”错误?
A:该商户没有开通D0垫资代付,如果是普通代付,扩展字段不需要传。
Q:商户后台批量付款到银行卡报“收款开户银行名称解析”错误?
A:请检查收款银行是否填写正确。
Q:发现代付订单处理中,一段时间后仍没有终态?
A:请联系酷宝支付运营,一般情况处理中订单,酷宝支付运营会在下一个自然日人工处理。
Q:提现失败?
A:请核实提现的对公账户是否正确。如果提现账户有变更需联系商务以及酷宝支付运营同事进行提现账户变更。

线下充值
Q:如何进行充值?
A:在商户后台选择线上充值,或者联系商务进行线下充值。

接口开发
Q:商户对接流程是什么样的?
A:酷宝支付提供两套环境给商户(联调环境、正式环境),商户应先在联调环境进行接口调试,联调环境使用的商户ID及密钥会在对接时由酷宝支付技术人员发出。联调环境接口调试完成之后,可以申请生产环境调试。生产环境商户ID及密钥由酷宝支付运营人员协助下发。生产环境调试完成后即可上线商用。
Q:联调环境怎样才算调试完成,如何获取联调资料?
A:联调环境是酷宝支付为了方便商户了解接口而搭建的一套环境,该环境不会连接真实银行,不可以走真实交易。但是该环境集成有模拟银行,部分交易可以模拟支付成功的情况并返回异步通知信息。
商户在联调环境调试时,要能完成接口的正确调用,在得到同步或异步返回信息后能正确解析数据,并完成酷宝支付返回数据的签名验证。
对接资料获取地址:https://pan.baidu.com/s/1LLMWGcGs19qVGaHbDZZ_8g,请根据商务协议下载需要的对接资料。网盘的压缩包中包含接口文档及接口示例demo,demo中包含联调环境调试时要用到的商户信息。
Q:生产环境如何开始对接,密钥及商户ID如何获取?
商户在完成联调环境的调试之后即可开始生产环境的对接。生产环境的商户ID及密钥需要酷宝支付运营同事进行配置,配置完成后,运营同事会发送密钥获取操作手册,商户按照操作手册即可获取到生产环境的密钥。
酷宝支付密钥共三个(签名用私钥、加密用公钥、验签用公钥),商户获取时需要注意进行区分。签名用私钥在发起交易时生成sign签名值时使用,需要运营同事配合下发下载连接;加密用公钥在部分交易中使用,对交易中的敏感字段(如银行卡号等)进行加密时使用,需要使用商户账号登录酷宝支付官网进行下载(酷宝支付公钥-加密公钥);验签用公钥在接收酷宝支付回调后验证签名时使用(同步回调和异步回调使用同一个公钥),获取方式同加密公钥,需要使用商户账号登录酷宝支付官网进行下载(酷宝支付公钥-验签公钥)。
Q:酷宝支付接口调起方式是?
商户需要采用Http请求的post方式调用酷宝支付接口,数据格式为key-value,即键值对形式。
Q:酷宝支付接口签名生成方式是?
签名是通过rsa签名算法的私钥加签算法生成的,商户需要先进行签名明文串的拼接,规则如下:
1.请求的所有参数,需要根据参数名=参数值的格式,按首字符字典顺序(ascii值大小)排序,若遇到相同首字符,则判断第二个字符,以此类推,排好序后以&符进行连接。
2.参与签名明文串拼接的这些参数必须来源于请求参数列表,并且除去列表中的参数sign、sign_type、sign_version。
3.请求参数列表中,值为空的字段不参与签名串的拼接。
4.签名明文串中拼接的数据应该是原始数据,而不是经过urlEncode之后的值。
签名明文串拼接完成后根据rsa私钥加签算法生成签名值。
Q:酷宝支付异步通知的数据格式是什么样的?
A: 酷宝支付异步通知发送方式为Http请求的post方式。数据格式为key-value,即键值对形式。
商户接收到酷宝支付的异步通知之后,应同步返回“SUCCESS”字符串。如未按要求正常返回,酷宝支付将分时段再次进行最多7次异步通知。7次异步通知全部接收失败后,商户只能通知查询接口进行主动查补订单状态。
Q:酷宝支付异步通知接收后如何验签?
A:酷宝支付异步通接收后需要进行验签,验签方法为rsa签名算法的公钥验证签名算法,该方法同样需要进行签名明文串的拼接。 生成签名明文串后根据公钥验证签名算法即可得到验签结果。
Q:网关支付—返回“支付方式或银行不支持”?
A:酷宝支付联调环境目前只支持TESTBANK,使用其它的银行都会报出“支付方式或银行不支持的错误”。
酷宝支付生产环境目前支持7家银行的支付,如果上送参数超出该范围,会报出“支付方式或银行不支持的错误”,生产环境支持银行列表请向酷宝支付运营人员索取。
Q:网关支付—生产环境请求发起流程?
A:http协议下post方式请求http://gate.yacolpay.com/mas/gateway.do,得到同步返回html页面,加载到浏览器就可以实现跳转银行。
Q:网关支付—账户类型seller_account_type选择会有什么影响?
A:http协议下post方式请求http://gate.yacolpay.com/mas/gateway.do,得到同步返回html页面,加载到浏览器就可以实现跳转银行。
seller_account_type字段有两个可选值(BASIC,D0_SETTLE)
BASIC:该值为默认值,即seller_account_type不上送时,则账户类型默认选该值。 BASIC类型的账户适用于开通T1结算的商户进行结算使用。
D0_SETTLE:该类型的账户适用于开通D0结算的商户进行结算使用。只签约了D0结算的商户必需传该字段,否则所有的入款金额将无法通过出款接口发出,只能在酷宝支付平台-商户主页通过提现功能提走。
Q::网关支付-订单状态应该怎么判断?
A:以下是部分订单状态的释义,商户可根据业务需要进行对应,其余的请参照接口文档中的说明。
pay_finished:表示用户已付款,我们已经收到银行扣款成功的通知。
trade_finished表示我们系统已经成功处理完订单并给你的酷宝支付账号加上余额,你可以看到余额变动。
Q:网关支付-pay_method字段怎么拼接?
A: 示例 -> pay_method="online_bank^1.00^TESTBANK,DEBIT,C";
说明 -> online_bank:固定值,表示使用网银支付
1.00:表示该笔订单将支付1元钱,保留两位小数位。
TESTBANK:银行简码,TESTBANK表示将使用测试银行进行支付(测试银行只在联调环境支持)
DEBIT:银行卡借、贷类型,DEBIT表示借记卡。
C:银行卡账户类型,C表示个人账户。
Q:网关支付-“请求已过期”怎么处理?
A:请求已过期的报错是因为request_time字段的值引起的。当reqeust_time字段所上送的值与当前时间相差15分钟以上(包括15分钟),则酷宝支付 接口会同步返回“请求已过期”的提示。所以request_time字段的值应尽量上送发起请求时的时间。
Q:批量代付到银行卡-“重复的请求号”?
A:该错误是由于batch_no字段的值与detail_list中的订单号重复导致的。支付为商户提供的是批量付款到银行卡的服务,同一次请求可以发最多300笔出款交易。
Q:批量代付到银行卡-收款人信息加密?
A:detail_list中的收款人信息,接口要求必需进行rsa加密处理。rsa加密时使用的密钥为酷宝支付提供的加密公钥.
注意:公钥加密,每次加密的结果都会变化,提醒您注意将加密结果做临时存储以备使用。
Q:批量代付到银行卡-账户是有钱的,提交出款却返回"账户余额不足"?
A:酷宝支付为部分商户开通了多个子账户,如使用错误的账户进行出款就会提示“余额不足”。
普通商户默认开通一个基本账户,该账户可用来入款和出款,默认结算周期为T+1。
当商户开通了D0结算时,则会增加一个D0结算账户。当商户入款需要使用该账户时,根据接口字段说明上送结算账户类型为D0,此时余额会添加到D0结算账户上。如果商户出款时,未上送账户类型,则默认使用基本账户出款,就会出现提示“余额不足”。如需正常出款,应在出款接口增加账户类型数据后提交,具体字段可参考接口文档。
Q:批量代付到银行卡-接口返回"卡bin机构不匹配"?
A:卡bin机构不匹配的问题,举例说明:接口上送的卡,根据卡号匹配出来是中国银行的卡,但是接口上送的银行简码是ICBC,这种情况就会返回"卡bin机构不匹配"的提示。
Q:快捷支付-调用流程应该是什么样的?
A:快捷支付调用流程如下
调用绑定银行卡 -> 使用得到的ticket及手机短信验证码调用绑定银行卡短信验证 -> 得到card_id进行存储 -> 使用得到的card_id调用绑卡支付接口 -> 使用得到的ticket及手机短信验证码调用支付发起短信验证 -> 支付完成
或者:
调用卡要素支付 -> 使用得到的ticket及手机短信验证码调用支付发起短信验证 -> 支付完成并获得card_id。
Q:快捷支付-返回证件号不匹配?
A:遇到此类返回,应确认两个信息:1.上送的银行卡信息是否正确,2.上送的商户系统用户ID是否给不同身份证号使用过。
说明:酷宝支付将快捷支付接口上送的商户系统用户ID和用户的银行卡信息进行关联存储,生成card_id返回给商户,如果商户再上送同样的商户系统用户ID,因为已经存在关联关系,所以如果身份证号对应错误的话,也会提示证件号不匹配。
Q:帮信通-接口使用说明?
A:商户对接时需要对接小微商户入网接口,卡要素支付接口,支付短信验证接口,单笔支付到银行卡接口等。
Q:帮信通-分账字段说明?
A:分账字段可通过如下示例进行理解:比如分账类型为1固定金额,分账金额为1块,交易金额为100块,那么银行卡扣款会扣100块,但是小微商户(也就是用户的账户)会收到99元,之后用代付接口也就有99元余额可用。酷宝商户的账户会收到1块分账的钱,可以在商户余额中显示。本例中只计算分账,其它的手续费不考虑。
没有结果
您可以尝试搜索其他的关键字,或者您可以联络我们获取更多信息。