常见问题以及解答 ================ demo问题 -------- 1.公钥私钥作用? 私钥加签使用,公钥验签使用 2.demo在哪下载? 请至开发者站点 http://acctdev.cloudpnr.com/wp-login.php 下载 demo (目前仅有 java 和 php 的 demo ),开发者站点登陆账号密码请向你们的主联系人获取。 3.有没有 C#、.NET 的 demo ? 目前仅有 java 和 php 的 demo ,其他开发语言可以参考开发者站点 NPC 服务器来加签。 4.开发者站点用户名和密码多少? 开发者站点登陆账号密码请向你们的主联系人获取。 5.加签/验签失败怎么办? 1. | 请确保按接口文档中的每个接口下方的本接口加签拼接顺序加签。 2. | 请确保加签/验签参数中没有空格,null 这种字样(如果你们认为接口参数不需要传值,因此传了 null ,null 其实也是一个值,需要参与加签,直接不传值即可),参数有无遗漏。 3. | 确保某些参数按接口要求,如 url 在签名前不 encode,传参才需要 encode,DivDetail 参数双引号问题,大小括号问题等等。 4. | 请确保商户号和商户客户号已替换为你们自己的。 参数问题 -------- 1.文档中入账客户号 in_cust_id 入账账号 in_acct_id 从哪获取? in表示入的意思,cust_id 和 acct_id 都是开户接口返回的(比如 user_cust_id ),快捷支付、代扣支付交易入账客户号可以固定填你们商户的账号和客户号(此信息也是邮件发送于你们的) 2.请求参数非法什么原因? 检查参数及其格式是否正确,如金额必须加 2 位小数;数字括号必须为半角等。 3.商户无此接口权限什么原因? 找销售申请开通该接口。 4.商户调用接口风险受限? 该报错为被我司风控拦截,可以找销售问下我们的风控。 5.企业开户,快捷绑卡,代扣签约等后台调接口返回 html 页面 此类接口,请用页面浏览器方式调用,具体可参考接口文档中每个接口调用方式。 6.开户失败 建议用真实身份证开户,身份证号首位请用 1-5 开头的。 异步回调问题 ------------ 1.异步应答先收到失败后收到成功 由于网络不稳定原因,存在先失败后成功的异步应答,请按成功的处理,具体参考接口文档异步应答接收规范。 2.收不到异步应答 请检查异步应答地址 bg_ret_url 是否外网可以访问,且目前只支持端口号 8000-9000 。 3.异步多久能收到? 异步返回通常都是秒级,存在个别几笔偶尔返回慢的情况。 4.测试环境短信验证码没收到 测试环境不会发送短信,短信验证码统一为 111111 。 5.测试环境快捷绑卡、取现绑卡、代扣签约同步返回“已受理”,没有收到异步响应? 请用指定卡bin测试。建行:银行代号 01050000 卡号:623251000000XXXX ,XXXX为 0000-1999 之间。 6.T+1 取现收不到异步应答 目前测试环境 T+1 取现没有异步应答,生产环境看银行端,成功应答有些有有些没有,失败了会有异步应答。 7.异步应答接收规范问题?(括号必读) 为了表示商户订单系统已经收到交易应答,商户必须在应答接收页面输出一段特殊的字符串 recv_ord_id_XXX (XXX为订单号),(详看文档 asharp.html#id11 3.异步返回方式的应答规则)。 交易问题 -------- 1.测试环境首次快捷支付失败 请至商户控台进行网银充值(测试环境只支持兴业银行,2 元以上),以免不够扣手续费而失败。 2.用户开户时报“短信验证码或短信唯一标识为空”什么原因? 开户时配置需要短信验证,因此开户前需要先调用短信验证码发送接口。 3.短信有效期多久? 15 分钟。 4.商户请求短信验证码接口,提示“短信发送过于频繁 ”是什么原因? 每个接口短信次数为 10 次。 5.绑卡失败 平安、浦发、上海、渤海、邮储需要完成银联在线签约才可以绑卡(绑卡的时候,在银行卡下面出现)。 6.企业开户,返回执照类型和执照号不匹配 普通营业执照企业,需要填营业执照、税务登记、组织机构代码;三证合一企业,需要填统一社会信用代码。 7.绑卡失败,持卡人身份信息或手机号输入不正确,验证失败 1. | 中行绑卡失败的,请客户咨询银行信息是否正确,特别注意,手机号只能预留在移动电话一栏,若预留在家庭电话则会出错。 2. | 工行绑卡失败的,请客户确认手机信息必须在工行柜面预留,其他渠道(如自助网银预留等)将会导致失败。 8.支付金额在1元以下显示失败。 由于各个银行方有最低金额限制,存在2元以下支付不成功的现象,请将支付金额调整为 2.01 元以上。 9.测试环境快捷绑卡、取现绑卡、代扣签约直接返回交易失败或者返回mock要素没有配置 请用指定卡bin测试。建行:01050000 卡号示例:623251000000XXXX ,XXXX 为 0000-1999 之间。 请用指定卡bin测试。建行:01050000 卡号示例:623251000000XXXX ,XXXX 为 0000-1999 之间。 10.取现失败,但是商户金额变少了,用户也并有收到钱 请核实贵司取现这个动作是否是转账成功后立即调取现接口的情况,此类问题是由于转账成功,但是取现失败,金额已转至用户账户,所以商户账户金额变少,针对该情况,建议增加调用余额查询接口判断用户是否有余额,再做转账操作。 业务逻辑问题 ----------------- - 1.特殊接口问题(如代发接口、快捷绑卡支付接口、通道代扣签约接口、直接代扣接口,这个5个) 由于这几个接口生产环境上还需要申请,但是目前在测试环境这些接口是都开通的,所以建议你们在测试环境调试该接口时先咨询我们商务,看是否能申请的到,避免测试调好后生产环境不能开通而导致你们重新改逻辑。 - 2.开户短信问题 开户接口的短信如不需要,可以找销售申请关闭开户短信功能。 - 3.快捷交易可以调哪些接口? | 我们提供多种快捷支付方式,你们可以根据自身需要来调接口,需要用到的接口如下: 1. | 个人开户接口->快捷绑卡->短信发送接口->充值支付接口(选择二段式快捷,详看下方充值支付接口(201)说明)。 2. | 推荐使用前台快捷绑卡代开户接口->充值支付接口(开户绑卡二合一接口,有页面有短信,详看下方充值支付接口(201)说明)。 3. | 快捷绑卡支付接口(开户绑卡支付三合一接口,后台)。 - 4.代扣可以调哪些接口? | 我们提供消费分期代扣和非消费分期代扣,你们可以根据自身需要来调接口,需要用到的接口如下: 1. | 产品录入接口->个人开户接口->消费金融类代扣签约接口(有页面)->充值支付接口(详看下方充值支付接口(201)说明)。 2. | 产品录入接口->个人开户接口->通道代扣签约接口(后台,无页面)->代扣支付接口(详看下方充值支付接口(201)说明)。 3. | 推荐使用产品录入接口->前台代扣绑卡代开户接口(开户绑卡二合一接口,有页面)->代扣支付接口(详看下方充值支付接口(201)说明)。 4. | 直接代扣接口(不需要开户,不需要绑卡,拿到四要素就能扣款,需找销售申请,需要一定资质,很难申请的到)。 - 5.取现/代发/代付可以调哪些接口? 1. | 对于用户主动取现形式的调用方式: | 个人开户接口->取现绑卡接口->转账接口(因快捷支付、网银支付、代扣支付支付全部分账给商户的情况下(钱在商户账户),需调转账接口)->取现接口(注意:为了避免转账成功,取现失败的情况,建议其中增加余额判断的方式,以防用户下次取现多转一笔钱)。 2. | 对于商户主动代发/代付方式调用方式(代付就是代发,叫法不同而已),可以用代发接口: | 直接调代发接口,(可以不用开户,直接发钱到用户银行卡;出账客户号和出账子账号表示是从哪个用户的虚拟账户出账,确保虚拟账户有钱)。 - 6.网银支付功能哪些接口?(测试环境只支持兴业银行) | 我们提供两种网银支付方式,一种是用户不需要开户直接网银支付,一种是已开户的用户网银支付,如下: 1. | 个人开户接口->充值支付接口( user_cust_id 需要传)。 2. | 充值支付接口( user_cust_id 可以不用传),交易类型 trans_type 选择免注册网银支付。 | 注:企业网银可以支持充值,即 trans_type 选充值,分账串填该企业的用户客户号和子账号;个人用户交易类型只能支付。 - 7.解绑用哪些接口? | 短信验证码发送接口->解绑快捷卡/代扣卡接口。 - 8.充值支付接口(201)说明 | 该接口包含网银、快捷、代扣三个支付方式功能 1. | 若使用快捷支付,则交易类型 trans_type 选择支付,充值类型 recharge_type 选择二段式快捷,需要调2次该接口,第一次 step_flag 传 01 ,收到验证码后,填入验证码(不需要填短信验证码日期和短信验证码订单号这两个参数), step_flag 传 02 。 2. | 若使用代扣功能,则交易类型 trans_type 选择支付,充值类型 recharge_type 选择代扣。 3. | 若使用网银,详看下方网银问题描述 - 9.分账串 DivDetails 怎么填? 1. | 不管使用快捷、代扣、还是网银支付,分账串中的入账客户号和子账户号均填你们商户的,表示钱全部支付给商户; 2. | 分账串目前不能分账其他人,只能分账给商户 - 10.手续费的问题 手续费的问题请联系贵司或者我司的销售,这是贵司与我司合作签合同或协议时双方约定的。 - 11.企业开户啥时候审核?什么时候有终态? 1. | 企业开户有专门的部门审核,审核日期 T+1 日,(以最近一次提交时间算,如1号提交,2号我们工作人员审核因企业资料不正确打回,假设2号企业修改资料后再次提交,则3号会再次审核)。 2. | 每次的审核结果都是通过异步发送,可以通过异步了解企业审核状态。 - 12.用户数据从其他支付公司怎们迁移到汇付? 批量调个人开户接口,再调后台快捷绑卡接口(该接口需要找销售申请开通),TPS最好不要超过10次/秒。 - 13.测试环境控台登陆不了怎么办? 请用这个地址登陆:https://mertest.cloudpnr.com/asharpadmin/ 。 - 14.可以不开户直接交易吗? 1. | 如果是个人用户,并且还用到快捷,那么就要开户。 2. | 只用网银交易(个人或企业)或者扫码支付(个人),并且不取现,那么可以不开户。 3. | 如果要取现就得开户,不管企业还是个人,除非你们用代付的方式给用户打钱(代付即是代发,代发可以不开户)。 4. | 代扣交易,如果贵司资质可以,可以找销售申请直接代扣接口。不用开户不用绑卡不用短信,什么都不用,拿到四要素就能扣钱,很诱人对不对?但很难申请的到。