常见问题

接入问题

在哪里注册入网

您可以点击 即刻体验 自定义登录名绑定手机号码,即可注册登录体验。

特殊类型执照怎么入网

医疗机构、事业单位、社会团体等特殊企业类型,存在无法在 国家企业信用信息公示系统 查询到信息的情况,此类企业入网时会报错, 需通过特殊流程完成入网,具体步骤如下:

1.商户自助入网/代理商协助入网,若失败则按下列步骤完成入网;

2.准备下列材料并提交工单,工单模板请选择 <特殊执照接入申请> ;

3.Adapay 运营协助处理,并通过工单反馈处理结果;

4.商户自助/代理商协助继续完成绑卡、签约、入驻、基础材料上传等入网步骤;

所需材料

材料列表

描述

营业执照

原件扫描件/照片或复印件加盖企业有色公章

法人身份证

正反面,提供原件扫描件/照片或复印件加盖企业有色公章

手持证件

法人手持营业执照及法人身份证照片

结算账户材料

实际结算账户对应的证件,基本存款账户、印鉴卡等

经营照片

门头照 1 张,内景照 1 张

入网申请表

点击下载 表格模板

商户简称填写是否有特殊要求

简称长度不能超过 30 位,且需要注意的是简称后续会展示在支付成功页面上。

支付宝和微信端的简称需分开修改,且每月只能修改一次,修改方式可参考 如何修改简称

_images/jiancheng.png

联系人手机号有什么用途

入网联系人手机号将作为后续申请手续费发票的登录账号,届时需要提供验证码,请填写真实、准确,谢谢。

申请发票

同一企业主体可以入网多少次

Adapay 支持同一主体(企业工商信息一致即同一主体)进件 5 次(包括状态正常和关闭的商户号)。

接入时哪些功能需要额外的渠道参数

您可在 Adapay 控制台中自行选择需要申请开通的支付渠道,对于大部分支付渠道您无需额外的渠道参数,包括:

  • 支付宝:扫码支付(正扫/反扫)、App 支付、手机网页支付(H5)、小程序支付、生活号支付。

  • 微信:扫码支付(反扫)。

少数支付渠道您需要先去微信申请相应的运营平台并获得渠道参数(AppID、授权目录),需自行申请的渠道及入口为:微信公众号支付 微信小程序支付

注意:当您申请微信公众号时,公众号类型需要选择服务号。

在哪里查询 AppID

  • 查询微信公众号 AppID

「登录微信公众号」-> 点击左栏下的「开发」->「基本配置」可查询到开发者ID,即 AppID。

_images/gongzhonghao_appid.png
  • 查询微信小程序 AppID

「登录微信小程序」-> 点击左栏下的「开发」->「开发管理」->「开发设置」可查询到 AppID。

_images/xiaochengxu_appid.png

支付宝 PID 怎么查

若您是代理商并需要关联您的支付宝 PID,您可以参考以下步骤查询:

进入「支付宝服务商平台 」-> 点击「我是服务商」进行申请 -> 申请成功后,进入「账户中心」->「账户管理」->「合作伙伴管理」中可查询到 PID。

若已经申请过支付宝「服务商」,可直接在账户中心去查询 PID。

_images/pid.png

微信授权目录配置规则是啥

授权目录即商户最后请求拉起微信支付收银台的页面地址。

配置规则:

  1. url 需”/”结尾,最多支持5个,设置完成后会有延迟,一般 30 分钟内生效;

  2. 如果授权目录设置为顶级域名(例如:https://www.weixin.com/ ),那么只校验顶级域名,不校验后缀;

  3. 如果授权目录设置为多级目录,就会进行全匹配,例如设置支付授权目录为:https://www.weixin.com/abc/123/,则实际请求页面目录不能为:https://www.weixin.com/abc/,也不能为:https://www.weixin.com/abc/123/pay/,必须为:https://www.weixin.com/abc/123/

  4. 商户实际的支付目录必须和 Adapay 控台微信公众号授权目录设置的一致,否则会报错“当前页面的URL未注册”;

如何配置微信公众号的网页授权域名

登录微信公众号平台,在「公众号设置」->「功能设置」->「网页授权域名」配置。

_images/wx_auth.png

提示:在微信公众号请求用户网页授权之前,开发者需要先到公众平台官网中的「开发」->「接口权限」->「网页服务」->「网页帐号」->「网页授权获取用户基本信息」的配置选项中,修改授权回调域名。

请注意,这里填写的是域名(是一个字符串),而不是URL,因此请勿加 http:// 等协议头;

其他详细信息请参考「 微信官方文档

花呗分期的使用规则是什么

花呗分期是蚂蚁金服推出的消费金融产品,用户在商家购物时使用花呗分期支付,订单全额实时支付到商家支付宝账户中,用户分期偿还花呗。

使用规则

  • 花呗分期目前支持分3、6、12期,分期产生的手续费需要由用户自己承担。

  • 使用花呗分期时

  • 若商户传了分期数,则用户不能使用其他支付方式(如余额宝等),只能使用花呗分期且分期数不可更改。

  • 若商户未传入分期数,当交易金额大于 100 元,用户可以选择花呗分期支付,也可以选择其他支付方式(如余额宝等);若交易金额小于100元,用户无法使用花呗分期。

计费模式

  • 花呗分期的总手续费实行“向下取整”的原则进行计算;

  • 当商品金额不能被分期的期数整除时,金额按分取整,除不尽的余数加入到第一期。无论是本金还是手续费,都依此规则执行。

微信实名认证

自2019年9月10日起,微信要求入驻商户需要按照微信最新标准进行商户名实名认证以获取商户的微信支付权限。

认证方式

三种认证方式

描 述

商家小程序(推荐)

商户联系人(可以非法人)扫描服务商拓展二维码进入小程序进行实名认证 指引手册企业版 指引手册小微版

Adapay 商户控台认证

法人在 Adapay 商户控台扫码完成实名认证

微信接口认证

对接微信提供的实名认证接口,发起实名认证

商家小程序

商户联系人通过扫描服务商拓展二维码、填写企业信息等六个步骤完成实名认证(以下步骤以企业为例)。

注:商户联系人为商家法人、财务人员或业务负责人等(建议法人作为联系人)。

• 一、下载拓展二维码

代理商(微信服务商)登录 微信服务商后台 ,在「服务商功能」->「特约商户管理」下载拓展二维码,给到商户联系人。

下载界面:

_images/qudaoma.PNG

拓展码示例:

_images/TZ1.png

• 二、商户联系人扫码,选择主体类型

联系人扫描服务商提供的二维码,,根据提示选择正确的主体类型,并准备好相关材料。

注:如商家此前已注册过微信,可联系之前注册的管理员再次扫码,会直接跳转到第6步进行微信子商户号授权。

关注公众号并点击通知消息

_images/ztix1.png

选择主体类型

_images/ztlx.png

• 三、填写联系人信息

联系人可以是商家店员、财务人员、业务负责人或法人自己。

_images/Nrenz3.PNG

• 四、填写商户信息

上传商户资质材料,微信会自动识别图片,需核对识别出的信息,并在提交材料后的720小时内完成商家认证所有流程。

-企业上传营业执照和法人证件,个体工商户上传营业执照和经营者身份证。

_images/Nrenz4.PNG

• 五、认证授权

授权有2种方式:法人实名的微信确认或者商户对公户打款验证,且提交商户资料后,需要在210个小时内完成授权,否则需重新提交资质。

若联系人是法人,则无需进行授权,可跳过此步骤。

a. 法人授权 —— 法人已绑卡微信进行授权

邀请法人使用微信扫描页面上的二维码或者点击“向XXX发送验证邀请”拉起微信消息列表后发送消息给法人,法人在微信上授权。

_images/Nrenz6.png

b. 对公账户汇款进行授权

当企业商家法人不方便授权时,可使用“对公账户汇款”进行验证,需要商家使用对公账户往微信支付指定的银行卡号汇入一笔指定金额(0.01元~1元),财付通会在T+1日原路退回.

_images/Nrenz7.png

• 六、联系人使用微信授权门店商户号

法人扫码或对公打款授权后,联系人会收到注册成功的微信消息通知,可点击此消息通知进入认证界面,或联系人再次扫描渠道商拓展二维码。进入认证界面后后,勾选对应的微信子商户号,完成微信子商户号授权。

_images/Nrenz8.png
Adapay 控台实名认证

您入网成功后,Adapay 会自动发起实名认证,您也可以联系法人在「控制台」->「商家信息」扫码提交材料完成实名认证,若认证失败也会实时在此页面反馈原因。

注:企业需使用法人实名过的微信扫码认证,个人商户需使用负责人实名过的微信扫码认证。

_images/ktsm.png

若您无法确认所属代理商(服务商),可在控制台中提交工单联系我们,我们会及时反馈。

微信接口认证

服务商也可通道微信提供的API接口,协助商户完成认证。 官方文档

实名认证常见问题(企业)

申请单资料填写相关问题

1. 如果商户没有完成开户意愿确认(实名认证),会有什么影响?

商户号没有完成开户意愿确认,则无法发起微信支付,微信客户端会提示“当前商户需补齐相关资料后,才可进行相应的支付交易,请商户联系对接的微信支付服务商”。

_images/Nrenz9.png

2. 一个联系人微信号可同时提交多个申请单吗?

不可以,一个微信只能有一个流程中的申请单(对应有一个申请单号,可在联系人微信中查看或微信服务商后台查询),需要完成当前申请流程后才可以申请下一个。

_images/Nrenz10.png _images/Nrenz11.png

3. 一个微信号可以成为多少个商家联系人吗?

一个微信号可以成为多个(不限)企业和个体户商家联系人,但是只能成为一个小微商家联系人。

4. 联系人姓名和手机号码一定要是“法人”的吗?

1)通过扫描渠道拓展二维码方式完成实名的,联系人可以是非法人;

2)通过 Adapay 控台扫码完成实名的,联系人必须是法人;

5. 扫码后提示:该主体已完成过商家注册,无需重复注册,请撤销该申请单并联系管理员“进行商户号授权”,如何处理?

该商家已经提交注册过企业信息,需按照页面指引撤销当前申请单,使用之前提交信息的管理员微信重新服务商拓展码,进入(门店)商户号授权页面,进行商户号授权。

_images/Nrenz12.png

6. 商户法人是境外身份,营业执照法人姓名与护照名称不一致,如营业执照上法人姓名为中文名称,护照名称为英文名,如何填写法人信息?

1)营业执照法人姓名处和护照名称处均填写为中文(英文),如 张三(zhangsan);

2)提供法人护照翻译件或证明函(证明函可自拟,并加盖公司鲜章),并与护照照片拼图上传于“证件照片正面”处,并请按Q20的方式提交人工审核。

7. 商户资料填写完毕,无法提交,页面提示:“经营者姓名/法定代表人与证件持有人姓名不一致 ,请检查后再试 错误码:-9”,如何处理?

填写法人姓名中可能存在空格或英文大小写等原因,导致填写的营业执照法人姓名与证件持有人姓名不一致,请检查修改后重新提交。

8. 填写商户名称、营业执照号、营业执照信息与证件信息一致,但注册提示名称和注册号不一致,如何处理?

检查信息填写无误后,需重新提供营业执照清晰版的照片,以免系统识别失败。若仍然无法解决,可按 “9” 的方式提交人工审核。

9. 当服务商遇到不可自行解决的场景,或者当信息正确的情况下,小程序或者系统识别错误怎么办?

这种情况下请使用小程序重复操作三次,系统驳回三次后在小程序上有人工审核提交入口,通过 人工审核 来提交相关商户资料。

_images/Nrenz13.png
申请单审核相关问题

10. 申请单被驳回,商户名称、注册号、法人姓名、证件有效期、企业类型均填写无误,如何处理?

请按照驳回提示,检查相关信息,按指引修改再提交。若核实后信息正确,仍然无法解决,请按 “9” 的方式提交人工审核。

_images/Nrenz14.png

11. 提示商户存在风险,暂不能通过审核,是什么原因?

商户风险较高,暂不支持接入。

13. 商家资料审核时长?

一般情况下,平台会实时查询工商接口,很快确认商家提交资料的真实性,完成审核。若不可实时确认时,则进入人工审核,人工审核会在三个工作日以内完成商家资料的核验。

申请单账户验证相关问题

14. 商家提交资料后,要在多久内完成法人授权或者打款验证?

240小时,否则申请单变成“已驳回”状态,需要重新提交申请单.

15. 打款验证的账户是否与资金结算账户一致?

打款验证为了证明主体真实性,跟结算无关。

16. 打款验证需要多久才有结果?

汇款后可在2小时内获知结果。

17. “对公账户汇款”汇错金额后,可以再汇一次吗?

可以,只要有一次打款正确就可以。

18. 商家使用“对公账户汇款”进行验证,汇款资金多久退回?

财付通会在T+1日原路退回,若未能正常退回,请提供开户银行、开户省份、开户城市信息,致电微信支付客服(电话:95017)核实处理。

19. 商家已使用“对公账户汇款”进行验证,但资料审核未通过,再次提交资料还需要打款验证吗?

需要。资料审核未通过,重新提交申请需重新进行打款验证。

20. 申请单多久内要完成整个开户意愿确认流程?

申请单要在30天*24小时/天=720小时内完成商户开户意愿确认,否则申请单状态会变成“已作废”。

21. 扫码后提示“申请单已被撤销,如有疑问请联系服务商”,请问该如何处理?

申请单已被商家撤销,或因商家未在规定时限内完成申请单注册,需要重新提交申请。

主体授权商户号确认相关问题

22.已收到微信支付商家助手“注册成功”提示,为什么交易时仍提示“当前商户需补齐相关资料后,才可进行相应的支付交易,请商户联系对接的微信支付服务商”?

注册成功消息仅代表合作意愿申请单注册完成,需重新扫描渠道商拓展码做商户号授权,完成商户号开户意愿确认。

23.商家在(门店)商户号授权时会看到其他服务商为他申请的子商户号吗?

不会,扫A服务商拓展二维码只能看到在A服务商下申请的子商户号。

24.商家变更过营业执照名称,扫码后显示主体名称非当前最新的商户名称,如何处理?

需要使用最新的证件重新创建申请单后完成商户号确认。 可在 国家企业信用信息公示系统 使用统一社会信用代码查询企业最新工商信息。

25.商家在(门店)商户授权时,为什么没有找到微信支付子商户号

可能有以下四个原因,可参考排查:

原因一: 服务商还没有帮商家在微信支付侧生成(门店)商户号,即商户还未在 Adapay 完成微信入驻,需先完成入驻;

原因二: 请检查拓展码右上角ID是否为商户入网时入驻的通道类型(如线上、线下),不要扫描错二维码;

原因三: (门店)商户号已经完成授权。建议服务商引导商家从微信小程序入口找到**“微信支付商家助手”**公众号,进入“商家注册”小程序首页,点击商家主体名称,查看“已授权商户号”列表。若子商户已经在授权列表则无需再次授权,商户可以使用微信支付;

原因四: 商户号的名称未满足微信支付的商户名称入网规则,有如下几种原因:

  1. 商户名称必须与商家营业执照上的名称一致。可在 国家企业信用信息公示系统 使用统一社会信用代码查询企业最新工商信息。

  2. 若个体工商户营业执照没有商家名称或者名称为“*”或者“***”,则商户名称应填 “个体户XXX”(XXX为营业执照上经营者姓名)。

  3. 若商家为小微商户,则商户名称应填 “商户_XXX”(XXX为小微商户身份证上的姓名)。

26.商家在(门店)商户授权时,没有找到微信支付子商户号,如何处理?

排除 25 中的4种原因,可点击页面中的 “点击搜索” 输入对应微信子商户号,勾选、添加、确认。

_images/Nrenz17.png

27.商户在 Adapay 入网后,如何查询微信子商户号?

1)商户可提供注册登录名、商户全称,联系 Adapay运营人员协助查询;

2)代理商推荐商户,可联系上级代理获取,代理商可前往「代理商控台」->「管理」->「商户管理」->「商户列表」->「查看及设置」->「商户详情」中查询;

_images/Nrenz16.png

28.搜索时商户号提示“商户号商户全称与当前商家名称不一致,无法进行确认”,是什么原因?

可能有以下几个原因

原因一: 当前显示商家名称非营业执照上最新名称,请按 24 方式处理;

原因二: 检查商户号主体全称和实名时注册的企业全称是否一致;

_images/Nrenz15.png

29.搜索时提示“该服务商下无此商户号,请联系服务商确认”,如何处理?

一般是商家扫错拓展码(如线上商户,但扫了线下的拓展玛),请联系服务商确认。

30.商户号已完成开户意愿确认,交易仍提示“当前商户需补齐相关资料后,才可进行相应的支付交易,请商户联系对接的微信支付服务商”

通常原因是实际交易的商户号与实际完成开户意愿确认的商户号不是同一个,请仔细检查核对。

31.如何确认商户已完成实名认证?

1)商户联系人扫描拓展码,在商户号确认页面,点击下方“已确认商户号”能查询到当前商户号,或点击搜索商户号后提示“该商户号已完成确认”;

2)商户管理员收到“微信支付商户助手”发送的已开通支付权限通知;

3)商户所属服务商登录 微信服务商 后台,在「服务商功能」->「特约商户管理」->「已创建商户号」中,查询到商户状态已变更为 「已确认」及「已获取」;

_images/Nrenz19.png _images/Nrenz18.png
其他问题

32.同一商家在同一服务商下入网多次,可以选择多个商户号进行开户意愿确认吗?

可以,一个营业执照在一个服务商下仅需注册一次,之后仅需给多个商户号进行最后一步的商户号确认即可。

33.完成授权后多久恢复正常交易?

完成门店商户号授权后即可正常交易,少数商户会有半小时左右的延迟。

控台使用问题

可以用账号密码登录控台吗

可以的,首先,注册时当您填写好登录名、手机号及验证码并点击「注册/登录」后,系统会跳转至登录密码设置界面,您可自定义登陆密码(至少包含数字、字母、特殊字符中的 2 种,且不少于 8 位), 后续登录时,您仅需点击「账号登录」即可切换至账号密码登录界面。

_images/zhanghaomima.png

忘记密码怎么办

若您忘记登录密码或者需要重置登录密码,可通过「账户登录页面」->「 忘记密码 」进行修改。

_images/wangjimima.png

如何配置微信的支付授权目录

您可在「控制台」->「立即配置」->「微信公众号」中添加支付授权目录。

授权目录 url 需”/”结尾,最多可配置5个,若需要删除已配置的授权目录(如配置数量已达5个,需修改/新增其他的支付授权目录),请提交工单,并注明企业全称、注册手机号以及告知需要删除支付授权目录详情。

可以补充入驻吗

当您在入网时未进行入驻,或仅入驻了支付宝/微信之一,您可通过此功能补充入驻。

菜单路径:「控制台」->「设置」->「商家信息」->「支付宝入驻信息」/「微信入驻信息」

如何修改入驻信息

若您入驻成功后,希望修改部分入驻信息,可通过以下方式修改:

微信

微信目前支持修改:商户简称(微信侧支付成功界面的收款人)、客服电话。

菜单路径:「控制台」->「设置」->「商家信息」->「微信入驻信息」

_images/ruzhuxiugai2.png

支付宝

支付宝可支持修改:商户简称(支付宝侧支付成功界面的收款人)、入驻的经营类目、费率类型、企业类型等。

菜单路径:「控制台」->「设置」->「商家信息」->「支付宝入驻信息」

_images/ruzhuxiugai1.png

注:“认证卡号及户名”是指,若支付时不能使用花呗功能,可通过调整企业的对公卡/法人对私信息来升级支付宝商户等级,升级后即可使用花呗功能。

提交按钮一直显示提交中

一般可能的原因有网络故障,页面缓存,可以尝试F5刷新页面或者清除缓存解决。

若需修改其他信息,请提交工单联系我们

证书使用的规则是什么

为保护您的交易安全,Adapay 接口报文全面使用 RSA 实现数字签名和敏感数据加密。

在 Prod 模式下进行真实交易,需先维护好您的安全证书。

菜单路径:「控制台」->「开发」->「证书管理」

_images/cer_manager.png

点击可查看 证书认证 详情。

生成证书的格式和方法

  • 格式要求

    • 秘钥长度:1024位

    • PKCS8

    RSA content
    
  • 生成方法

方法一(推荐):

终端窗口执行以下步骤生成交易所需 RSA 秘钥(Windows 环境需提前下载安装 OpenSSL 库

第一步:生成私钥

openssl genrsa -out rsa_private_key.pem 1024

第二步:根据私钥生成对应的公钥:

openssl rsa -in rsa_private_key.pem -pubout -out rsa_public_key_1024.pub

第三步:私钥转化成pkcs8格式,尖括号的意思是:将转化好的私钥写到rsa_private_key_pkcs8.pem文件里(只需要 RSA content)

openssl pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt > rsa_private_key_pkcs8.pem

方法二(仅限 Windows 操作系统,已安装JDK):

下载 AdapayUtils

方法三(仅限 Windows 操作系统,未安装JDK):

下载 未安装JDK

API Key 和交易秘钥有关系吗

  • API Key

商户开户以后会有两个 API Key,一个是 api_live_XXXX,另一个是 api_test_XXXX:

api_live_代表 prod 环境,api_test_代表 mock 环境,mock 环境用于模拟测试。API Key 可以在控制台中维护,变更后原 API Key 失效。API Key 代表商户的身份,与商户一一对应。

API key 与交易秘钥配套使用才能正常发起交易。

  • 交易秘钥

Adapay 与商户之间采用 RSA (SHA1withRSA) 算法进行签名认证,商户和 Adapay 各有一套秘钥。控制台配置时,请只上传商户 RSA 秘钥公钥部分。

请求时:商户用自己的 RSA 私钥对数据进行签名,Adapay 用商户在控制配置的 RSA 秘钥进行验证。

响应时:Adapay 用自己的 RSA 私钥进行签名,商户用 Adapay 的 RSA 公钥进行验证,Adapay RSA 公钥可以在控制台获取.

入网后结算账户可以修改吗

可以,入网成功后,若您需要修改您的结算账户,可以在「控制台」->「商家信息」->「结算账户信息」中更换。

请注意:对私结算仅限法人对私账户。

_images/jiesuan.png

交易查询功能可以查询哪些信息

您可在控制台中,查询交易记录,可查询支付渠道、交易状态、交易金额、手续费金额、分账等信息,也支持导出查询文件。

菜单路径:「控制台」->「交易」->「交易记录」

_images/trade_query.png

退款查询功能可以查询哪些信息

您可在控制台中,查询交易退款的订单。可查询订单号、退款通道、退款时间、退款金额、退款手续费、交易状态等信息,也支持导出查询文件。

菜单路径:「控制台」->「交易」->「退款记录」

_images/refund_query.png

余额查询里面的不同账户是什么意思

各账户的含义及作用如下:

账户名称

含义及作用

商户简称

商户基本账户,账户余额可用于交易、退款及结算

手续费账户

可在控台中使用网银充值功能充值金额,目前此账户余额仅可用于交易手续费外扣模式下的手续费扣除

临时过渡户

交易(或分账)未确认前的过渡户,确认后账户余额自动调整到各分账账户中

控台界面:

_images/yuechaxun.png

技术问题

交易时上传哪一个 AppID

App_ID 为 Adapay 给商户分配的 ID ,不是微信原生的 AppID。

在开通微信公众号/小程序等相关功能时已经绑定了 Adapay 的 App_ID 与微信的 AppID 之间的映射关系,故交易时候请传入 Adapay 的 App_ID。

Adapay App_ID:

_images/Adapay_Appid.png

微信 AppID:

_images/wx_Appid.png

Adapay 异步通知方式是什么

关于成功消息通知,Adapay 采用支持 2 种异步通知的方式:

1.mqtt

2.HTTP(S)(推荐使用)

具体使用方式请参照 SDK 中异步处理代码. 详见异步通知模块

异步通知可以重发吗

Adapay 商户控台和代理商控台均支持手动重发异步通知。目前控台仅支持 HTTP(s) 异步通知重发

常见报错有哪些

  • security_exception

签名错误,常见为商户公私钥不匹配导致,请检查秘钥配置。

  • request_parameter_error

请求参数错误,常见为,请求参数不合法,具体是哪个参数错误,请查看返回信息中的 invalid_param 中的信息,invalid_param”:”open_id”。

  • config_exception

配置错误,常见为传入的配置信息有误,例如:商户状态异常或不存在,AppID 不存在,支付渠道未配置等,错误信息详见 error_msg,”error_msg”:”商户状态异常或不存在” 。

  • channel_response_code_fail

支付渠道响应码错误。常见为通道异常情况,您可附上订单号在工单系统提交工单,我们第一时间为您查询问题。

  • system_exception

系统异常,是指 Adapay 系统异常。

  • charge_id_not_exists

对应支付记录不存在,对应订单请求不存在。

  • request_order_no_repeate

请求订单号重复,是指该笔订单号已存在。

  • channel_error

通道异常,是指支付通道出现问题。

  • mer_not_register

商户未入驻,是指商户在 Adapay 系统中尚未完成渠道入驻。

  • 商户状态异常

您的交易命中了支付宝/微信的风控规则。 申诉

  • bill_not_exists

账单生成异常,常见原因为当天的跑批任务出现异常,您可附上订单号在工单系统提交工单,我们第一时间为您查询问题。。

  • pay_channel_not_config

支付渠道未配置,请在控台配置支付渠道。

  • cash_not_config

取现功能未开通,请联系运营人员进行相应配置。

返回码说明

  • iOS 返回错误码说明

参数

说 明

0000

订单支付成功

0001

订单支付失败

0002

订单支付中

0012

支付结果未知

0013

用户取消

0020

参数错误

0031

网络出错

0032

其他错误

  • Android 返回错误码说明

参数

说 明

0000

订单支付成功

0001

订单支付失败

0002

订单支付中

0012

支付结果未知

0013

用户取消

0020

参数错误

0031

网络出错

0032

其他错误

SDK 相关

  • 微信公众号支付或小程序支付时,服务端 SDK 已成功返回正确的 Payment 对象,调用前端 JS SDK 为什么没有反应?

请检查调用 JS SDK 方法是否是在页面刚加载的时候,建议页面完全加载完以后再进行调用,或通过按钮事件触发调用方法。

  • SDK 对版本有要求吗

有的,比如 PHP 需要5.6 及以上版本。

  • debug 发现签名结果为空

请检查签名私钥是否设置,且格式为PKCS8。

建议您在开发之前阅读 SDK开发指南

  • SDK导入项目后,发现缺失jar包

接入本SDK需依赖第三方库,需要手动引入 相关依赖

  • 调用入驻接口MerchantEntry.create时失败,抛异常提示:渠道号无子商户录入权限,请检查后重试

一般可能是商户的微信验证没有做,请联系销售人员,协助开通权限。

其他问题

手续费发票申请

Adapay 支持在线申请手续费发票(支持专票和普票),您可使用入网联系人手机号登录我们的「汇付商户发票助手」小程序并申请开具手续费发票,可支持实时进度的查询、纸质/电子发票的选择等功能。

9月起我们将全面推广使用小程序申请发票,如果后续在使用中有特殊开票需求、或者小程序开票过程中有疑问,请提交工单,我们会及时跟进处理。

Adapay 有交易限额吗

交易的限额可以参考各支付渠道的支付限额:

  • 微信

  • 支付宝

支付退款时效是多久

退款时效目前以各支付渠道为准:

支付类型

可支持退款时长

入账时间

微 信

360 天

最晚3个工作日

支 付 宝

360 天

最晚3个工作日

快 捷

180 天

/

云 闪 付

180 天

/

可支持当日/跨日退款、单笔/多笔、部分及全额退款。

什么叫部分退款

Adapay 支持部分退款,例如原交易 100 元,支持退 50 元,且支持多笔退款,但退款总金额不能超过原始订单金额。

怎么理解退款退费

Adapay 退款支持同时退费(这里说的手续费是指:通道的手续费)。

  • 整单退款退还所有手续费。

  • 部分退款,退手续费根据费率计算后退还。例如:订单金额 1,000 元,费率为 4‰,原手续费 4 元,若退款 500 元,则退手续费 2 元。

注意:如果计算出来的手续费存在小于 1 分钱,则分后的金额不退。例如:计算的退款手续费 1.687,实际退款手续费:1.68(该情况只会在部分退款中存在)。

  • 多笔退款的最后一笔退款会把之前小于 1 分钱少退的部分一并退还。

例如:上一笔退款中少退了 0.007,会在最后一笔退款一并退还之前少退的这部分金额。

具体退费情况,微信/支付宝也会进行控制。

分账交易怎么退款

目前分账功能支持多次部分退款,退款总金额不能超过原始订单金额,且手续费是退还给原手续费承担方。

退款时支持传入分账对象列表,列表中退款对象必须是之前创建支付时参与过的分账方,且仅支持传入金额,不支持传入退款比例,您可以通过比例算好金额后,传入分账对象中。

  • 例如

创建支付对象时,交易金额100.00元,分账对象列表包含A、B、C三个分账对象,分账金额分别为90.00元、6.00元、4.00元,手续费承担方为A,手续费金额假设为0.07元。

创建退款对象时,退款金额50.00元,分账对象列表支持的场景如:

1、包含A、B、C三个分账对象,分账金额分别为45.00元、3.00元、2.00元。

2、包含A、B两个分账对象,分账金额分别为47.00元、3.00元。

本次手续费退款金额为50.00 / 100.00 * 0.07并向下取整 = 0.03元,退给A,当总退款金额等于100.00元时,Adapay系统会将剩余未退的手续费金额进行全额退回

对账单怎么获取

目前您需要通过接口获取到对账单下载地址,并通过该下载地址获取到历史支付、退款交易清单。 对账单下载接口

或者您也可以在控制台中下载交易明细,详情可参考控制台操作手册。

代理商、商户、企业/个人用户有什么区别吗

  • 代理商:为 Adapay 推荐商户,与我司签署推广合作协议。

  • 商户:是业务经营的主体,可通过 Adapay 控台极速入网也可通过渠道进件接口进件,需要与我司签署支付服务协议。

  • 企业/个人用户:是商户业务的参与方,可参与商户业务流水分账。

分账对象的开户审核时效是多少

企业是 T+1 日反馈,个人是实时返回的。

分账对象的开户审核进度怎么看

可在商户控制台:「管理」 -> 「用户管理」-> 「企业用户开户查询」查看,可查询用户(企业)开户申请信息、审核进度、并支持修改待审核信息。

_images/yonghuzt1.png

用户列表在哪里查

可在商户控制台:「管理」 -> 「用户管理」-> 「用户信息查询」中通过“时间范围(查询时间范围需小于等于 90 天)”和(或)“用户 ID”“结算账户 ID”查询已开户成功的用户列表。

注:未绑定结算卡的用户可参与分账,但无法结算,请及时绑定结算卡。

_images/yonghuzt.png

用户余额账户查询怎么看

在商户控制台:「管理」 -> 「用户管理」-> 「用户信息查询」中找到用户信息,点击右侧「查询用户余额」查看用户的账户余额。

_images/yonghuyue.png

企业工商的信息可以修改吗

可以,Adapay 商户控台支持修改企业工商信息(除统一社会信用编码)、法人信息、联系人信息、受益人信息、证件照片等,详情可参考操作手册;

旧的账号信息如若不再使用,可提交工单让我们为您关闭账号权限。

若您还有其他的问题,也可以提交工单联系我们,我们的工程师会尽快为您处理,谢谢。

有疑问?您可在线沟通或反馈,点击 联系我们