常见问题

demo 问题

1.公钥私钥作用？

私钥加签使用，公钥验签使用

2.demo 在哪下载？

请至 开发者站点 下载 demo (目前仅有 java 和 php 的 demo )，开发者站点登录账号密码请向你们的主联系人获取。

3.有没有 C#、.NET 的 demo ？

目前仅有 java 和 php 的 demo ，其他开发语言可以参考开发者站点 NPC 服务器来加签。

4.开发者站点用户名和密码多少？

开发者站点登录账号密码请向你们的主联系人获取。

5.加签/验签失败怎么办？

1. 请确保按接口文档中的每个接口下方的本接口加签拼接顺序加签。
2. 请确保加签/验签参数中没有空格和 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为订单号)，（详看文档 异步应答接收规范）。

交易问题

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 之间。

10.取现失败，但是商户金额变少了，用户也并有收到钱

请核实贵司取现这个动作是否是转账成功后立即调取现接口的情况，此类问题是由于转账成功，但是取现失败，金额已转至用户账户，所以商户账户金额变少，针对该情况，建议增加调用余额查询接口判断用户是否有余额，再做转账操作。

业务逻辑问题

1.特殊接口问题（如代发接口、快捷绑卡支付接口、通道代扣签约接口、直接代扣接口，这个 5 个）

由于这几个接口生产环境上还需要申请，但是目前在测试环境这些接口是都开通的，所以建议你们在测试环境调试该接口时先咨询我们销售，看是否能申请的到，避免测试调好后生产环境不能开通而导致你们重新改逻辑。

2.开户短信问题

开户接口的短信如不需要，可以找销售申请关闭开户短信功能。

3.快捷交易可以调哪些接口？

我们提供多种快捷支付方式，你们可以根据自身需要来调接口，需要用到的接口如下：

1. 个人开户接口->快捷绑卡->短信发送接口->充值支付接口（选择二段式快捷，详看下方充值支付接口说明）。
2. 推荐使用前台快捷绑卡代开户接口->充值支付接口（开户绑卡二合一接口，有页面有短信，详看下方充值支付接口说明）。
3. 快捷绑卡支付接口（开户绑卡支付三合一接口，后台）。

4.代扣可以调哪些接口？

我们提供消费分期代扣和非消费分期代扣，你们可以根据自身需要来调接口，需要用到的接口如下：

1. 产品录入接口->个人开户接口->消费金融类代扣签约接口（有页面）->充值支付接口（详看 充值支付接口）。
2. 产品录入接口->个人开户接口->通道代扣签约接口（后台，无页面）->代扣支付接口（详看 充值支付接口）。
3. 推荐使用产品录入接口->前台代扣绑卡代开户接口（开户绑卡二合一接口，有页面）->代扣支付接口（详看 充值支付接口）。
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. 代扣交易，如果贵司资质可以，可以找销售申请直接代扣接口。不用开户不用绑卡不用短信，什么都不用，拿到四要素就能扣钱，很诱人对不对？但很难申请的到。