常见问题

接入问题

在哪里注册入网

您可以点击 即刻体验 使用手机号码及短信验证码,即可注册登录体验,发起 Mock 模式(测试模式)交易测试。

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

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

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

_images/jiancheng.png

联系人手机号有什么用途

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

申请发票

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

Adapay 支持同一主体(企业工商信息一致即同一主体)进件 5 次(包括状态正常和关闭的商户号),但注册手机号、联系人邮箱不能重复。

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

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

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

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

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

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

在哪里查询 AppID

  • 查询微信公众号 AppID

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

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

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

_images/xiaochengxu_appid.jpg

支付宝 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未注册”;

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

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

使用规则

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

  • 使用花呗分期时

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

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

计费模式

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

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

微信实名认证

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

认证方式

认证方式

描述

商家小程序

商户扫描服务商拓展二维码进行实名认证 指引手册

Adapay 控台认证

在控台发起实名认证

微信接口认证

通过微信提供的接口发起实名认证

商家小程序

商户通过扫描服务商拓展二维码、填写企业信息等六个步骤完成实名认证。

  • 扫描拓展二维码

代理商(微信服务商)登录 微信支付后台 ,下载拓展二维码,给到商户联系人。

_images/qudaoma.PNG
  • 商户扫码,选择主体类型

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

_images/Nrenz2.PNG
  • 填写联系人信息

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

_images/Nrenz3.PNG
  • 填写商户信息

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

_images/Nrenz4.PNG
  • 认证授权

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

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

_images/Nrenz6.png
  1. 对公账户汇款进行授权

当企业商家法人不方便授权时,可使用方式二打款验证代替.

_images/Nrenz7.png
  • 联系人使用微信授权门店商户号

联系人可进行如下操作,勾选全部的商户号,完成门店商户号授权:

 再次扫描商家实名认证二维码

 点击注册成功的微信消息通知

_images/Nrenz8.png

控台实名认证

您入网成功后,Adapay 会自动发起实名认证,您也可以后续前往「控制台」->「微信实名认证」完成实名认证,若认证失败也会实时在此页面反馈原因。

注:需使用法人实名过的微信进行扫码认证。

2019年11月15日前入网的商户请参考以下流程:

您可在「控制台」->「微信实名认证」参考 认证指引 完成实名认证,若您无法确认所属代理商(服务商),可在控制台中提交工单联系我们,我们会及时反馈。

微信接口认证

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

实名认证常见问题

问 题

解 答

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

汇款后可在2小时内获知结果,请联系人注意微信消息通知

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

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

如何更换联系人?

目前一个营业执照可以绑定多个商家联系人,可由新的联系人发起申请单并完成开户意愿确认

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

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

实名认证时显示主体已完成过商家注册,无需重复注册该怎么办?

根据提示,联系商家的管理员直接进行授权即可

服务商如何确认商户号是否已完成开户意愿确认?

1)服务商引导商家打开「商家注册」小程序,点击「商家主体名称」->「已授权商户号」 ,确认商户号是否在授权列表里

2)服务商登录商户平台,在「服务商功能」->「特约商户管理」->「已创建商户号」 查看商户号是否已经完成开户意愿确认

3)服务商调用查询商户号授权状态接口来确认

商户扫码后未显示需认证的商户名称怎么办?

排除以下情况后,请尝试点击「点击搜索」,输入商户号进行搜索

1)商户已成功入驻微信,且有对应的微信商户号

2)请检查服务商二维码右上角ID是否为微信商户号对应的渠道号(也可通过上图截图中的服务商商户号与微信商户号对应的渠道号进行核对)

3)请确认(门店)商户号是否已经完成授权。建议引导商家从微信小程序入口找到「商家注册」小程序,进入小程序首页,点击商家主体名称,查看「已授权商户号」列表。若子商户已经在授权列表则无需再次授权,商户可以使用微信支付

搜索时提示“商户号商户全称与当前商家名称不一致,无法进行确认” ,怎么办?

1)请核实商户号全称与商家相关证件(如营业执照等)上的名称是否一致。如一致,请确认其是否做过工商注册名称变更,可在 国家企业信用信息公示系统 中查询其变更情况

2)如由于工商变更导致报错,请提供实名认证申请单号、微信商户号、商户变更前名称、商户变更后名称、报错截图以及在国家企业信用信息公示系统查询到的工商信息变更截图至 Adapay 运营邮箱:adpyyb@huifu.com

控台使用问题

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

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

_images/zhanghaomima.png

忘记密码怎么办

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

_images/wangjimima.jpg

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

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

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

可以补充入驻吗

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

菜单路径:「控制台」->「商户信息管理」->「微信入驻」/「支付宝入驻」

_images/buchongruzhu-weixin.png

如何修改入驻信息

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

微信

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

菜单路径:「控制台」->「商户信息管理」->「微信入驻」->「微信入驻修改」

_images/ruzhuxiugai-weixin1.png

支付宝

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

菜单路径:「控制台」->「商户信息管理」->「支付宝入驻」->「支付宝入驻修改」

_images/ruzhuxiugai-zhifubao1.png

详情页面:

_images/ruzhuxiugai-zhifubao2.png

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

提交按钮一直显示提交中

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

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

证书使用的规则是什么

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

无论您在 Mock 模式下进行交易测试还是在 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

技术问题

交易时上传哪一个 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(推荐使用) :MQTT具有低开销、低带宽占用 、极少代码显示的特点,不需要商户提供 URL 回调地址,也可以使用URL回调。

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 及以上版本,因为目前 mqtt 消息推送尚不支持 5.6 以下版本。

  • debug 发现签名结果为空

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

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

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

接入本SDK需依赖第三方库,需要手动引入依赖如下:

httpclient-4.5.2

org.eclipse.paho.client.mqttv3-1.2.0

fastjson-1.2.48

httpmime-4.5.2

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

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

其他问题

手续费发票申请

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

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

Mock 模式和 Prod 模式的区别

  • Mock 模式

当您尚未入网且未获得自身的渠道参数时,您可以在 Mock 模式中测试支付流程,具体可见 自助联调

  • Prod 模式

是指您已完成了入网及渠道参数的配置,可以在该模式下进行真实的支付交易。

注意:建议商户在prod模式下测试,真实的支付只能在 Prod 模式下进行,如依赖微信、支付客户端的公众号支付、小程序支付等, 商户也可以根据不同环境注册不同的账号进行联调测试等,谢谢。

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 日反馈,个人是实时返回的。

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

您好,修改已入网商户的工商信息可能会对交易有影响,建议您使用新的手机号和邮箱以及变更后的材料重新入网和交易, 旧的账号信息如若不再使用,可提交工单让我们为您关闭账号权限。

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

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