跳到主要内容

支付参数配置说明文档

一、微信支付配置概览

必要条件

根据不同需求,申请不同账号:公众平台账号、商户平台账号、开放平台账号

image-20221227172237398

参数获取概览图

image-20221227172331430

注:每个端的商户号MCHID、api秘钥和api证书都是同一个,而appid 和APPsecret是不同的。

1) 微信内h5支付

image-20221227172430573

image-20221227172446337

image-20221227172508671

image-20221227172527464

image-20221227172541064

2) 微信外h5支付

支付配置同上“微信内h5支付

3) 小程序

image-20221227172644205

image-20221227172655396

image-20221227172706754

image-20221227172722986

image-20221227172736562

4) app

image-20221227173119571

image-20221227173135262

image-20221227173146212

image-20221227173158280

image-20221227173209792

5) pc

注:如果PC 和H5 端都有,那这里配置H5 的支付参数就可以,详见微信内h5支付;如果只有PC没有H5端,可以参考下面

image-20221227173237770

image-20221227173249003

image-20221227173259883

image-20221227173310423

image-20221227173322716

接下来要配置好微信商户平台的设置

二、微信各平台申请注册流程

1) 微信公众平台注册(企业)

腾讯微信公众平台官方文档:https://kf.qq.com/product/weixinmp.html

1、打开微信公众平台官网:https://mp.weixin.qq.com/ 右上角点击“立即注册”;

image-20221227173443212

选择帐号类型;

image-20221227173502765

2、填写邮箱,登录您的邮箱,查看激活邮件,填写邮箱验证码激活;

image-20221227173523904

image-20221227173538001

3、 了解订阅号、服务号和企业微信的区别后,选择想要的帐号类型;

image-20221227173600632

下图为订阅号、服务号和企业微信的在手机端展示效果;

image-20221227173622485

4、信息登记,公司请记得选择企业->企业类型;

选择企业之后,填写企业名称、营业执照注册号,选择注册方式;

image-20221227173642225

2) 微信小程序注册

腾讯微信小程序官方文档:https://kf.qq.com/product/wx_xcx.html

1、注册方法

在微信公众平台官网首页(mp.weixin.qq.com)点击右上角的“立即注册”按钮。

image-20221227173724983

2、选择注册的帐号类型

选择“小程序”,点击“查看类型区别”可查看不同类型帐号的区别和优势。

3、填写邮箱和密码

请填写未注册过公众平台、开放平台、企业号、未绑定个人号的邮箱。

4、激活邮箱

登录邮箱,查收激活邮件,点击激活链接。

5、填写主体信息

点击激活链接后,继续下一步的注册流程。请选择主体类型选择,完善主体信息和管理员信息。

选择主体类型:

image-20221227173750840

主体类型说明如下:

image-20221227173808126

填写主体信息并选择验证方式

企业类型帐号可选择两种主体验证方式。

方式一:支付验证

需要用公司的对公账户向腾讯公司小额打款(一般都是几毛钱)来验证主体身份,打款信息在提交主体信息后可以查看到。

请根据页面提示,向指定的收款帐号汇入指定金额,过后会原路退还到公户。

温馨提示:请在10天内完成汇款,否则将注册失败。

方式二:微信认证

通过微信认证验证主体身份,需支付300元认证费。认证通过前,小程序部分功能暂无法使用。

如需了解主体验证方式请“点击这里”

填写管理员信息

image-20221227173834581

确认主体信息不可变更

image-20221227173851707

3) 微信开放平台注册

腾讯微信开放平台官方文档:https://kf.qq.com/product/wxkfpt.html

1、打开微信开放平台https://open.weixin.qq.com 右上角点击“注册”;

image-20221227173927908

2、填写基本信息;

image-20221227173947776

3、邮箱激活;

image-20221227174011199

4、完善开发者资料。

image-20221227174039974

image-20221227174051036

4) 微信支付商户接入(企业)

腾讯微信支付商户官方文档:https://kf.qq.com/product/wechatpaymentmerchant.html#hid=hot_faq

企业接入微信支付,必须有营业执照,且营业执照上的主体类型一般为个人独资企业、合伙企业、有限公司、有限责任公司。

申请资料

1、营业执照:彩色扫描件或数码照片

2、组织机构代码证:彩色扫描件或数码照片,若已三证合一,则无需提供

3、法人身份证:彩色扫描件或数码照片

4、对公银行账户:包含开户行省市信息,开户账号

提交资料指引

1、进入微信支付商户平台页面,点击“接入微信支付”按钮

image-20221227174143238

2、使用微信扫码(微信号需通过银行卡实名验证,否则将无法进入下一步)

image-20221227174202392

3、登录确认消息会发送到对应微信上,请点击“允许登录”

image-20221227174221262

4、填写姓名、手机号、邮箱,以创建申请单

image-20221227174239047

5、进入填写商户资料页面,选择主体类型为“企业”后,按页面提示提交相关信息,详见下图:

image-20221227174317904

image-20221227174349163

image-20221227174409919

image-20221227174425309

image-20221227174445906

image-20221227174457874

6、点击下一步,预览申请单内容,并确认提交

image-20221227174516603

7、提交后,系统会先对资料进行校验,大约需要3~5秒,请耐心等待

image-20221227174549145

8、若系统校验通过,页面会引导进行账户验证,请使用结算账户向财付通指定账户汇入指定金额 汇款验证指引

image-20221227174621501

9、账户验证通过后,即已完成申请资料提交

image-20221227174645875

微信支付会在1~2个工作日内完成资料审核,并通过公众号、短信、邮件向超级管理员通知审核结果。

三、微信各平台功能配置

1) 微信公众号配置

1、公众号设置

登录公众平台—>公众号设置—>功能设置—>网页授权域名/JS接口安全域名

image-20221227174825054

其中:

JS接口安全域名:填写API地址 ,例如:buyer-api.javamall.com.cn

网页授权域名:填写m端访问地址,例如:m-buyer.javamall.com.cn

a、将下载好的 .txt授权文件 放到前端项目中的 /static目录下,重新打包下。

image-20221227174851284

image-20221227174901853

b:在公众号授权页面,填写域名那里直接填写路径,www.xxx.com/static ,

如:m-buyer.javamall.com.cn/static

2、设置白名单

进入微信公众账号--开发菜单--基本配置--IP白名单,将web项目所在的服务器的外网IP地址填写到IP白名单中,如果有多个,中间使用回车隔开。

image-20221227174959550

image-20221227175008184

3、微信公众号绑定开发者微信号

https://mp.weixin.qq.com/cgi-bin/frame?t=advanced/dev_tools_frame&nav=10049&token=1632769894&lang=zh_CN

image-20221227175030398

开发菜单 -->开发者工具 --> web开发者工具 --> 绑定开发者微信号

image-20221227175045689

image-20221227175055437

4、微信消息模板清理

模板消息→我的模板→删除

image-20221227175121201

2) 微信小程序配置

1、绑定微信公众号,开放平台

登录 微信小程序后台,设置---关联设置

image-20221227175151259

2、微信小程序添加项目/体验成员

https://mp.weixin.qq.com/wxamp/user/manage?action=index&use_role=1&token=784367483&lang=zh_CN

image-20221227175212350

image-20221227175222407

3、添加微信移动端客服

当微信移动端有客户咨询,这里绑定的微信号就可以收到并回复消息。

image-20221227175242693

4、微信小程序参数配置

https://mp.weixin.qq.com/wxamp/devprofile/get_profile?token=784367483&lang=zh_CN

在 “开发”菜单下-->“开发设置”

小程序appid和appsecret

image-20221227175301858

小程序代码上传秘钥和IP白名单

image-20221227175318115

小程序 服务器域名

分别将各个端api地址填好

uploadFile和downloadFile都加下oss域名(必须是https)

小程序生成海报前先配置域名,并且小程序已经上线,才能正常生成海报

image-20221227175340337

小程序 业务域名

这里填写wap端访问地址

image-20221227175356159

小程序添加插件

设置 菜单 --> 第三方设置 --> 插件管理

image-20221227175420300

3) 微信商户平台设置

微信商户平台需要开启的功能:

image-20221227175454022

1、配置支付授权目录/Native支付回调链接/H5支付域名

进入微信支付商户平台--产品中心--开发配置,修改公众号支付的支付授权目录,填写wap端域名。

Native支付回调链接 是 PC 扫码支付用到的 ,需要配置买家端api地址

注:一定要根据自己域名情况,区分好https或者http

H5支付域名 是主域名

image-20221227175518163

image-20221227175528256

image-20221227175537260

2、appid账号管理

关联不同类型的账号之后,才可以在不同端使用微信支付

image-20221227175604180

4) 微信开放平台设置

微信开放平台配置对应的是信任登录,不同端要分别创建不同应用,并且要通过认证和绑定好同一个微信商户号/公众号

image-20221227175635569

移动应用创建流程

登录微信开放平台https://open.weixin.qq.com ->【管理中心】->【移动应用】->【创建】,步骤如下:

1、填写应用基本信息,包括应用名、应用官网、下载地址等;

image-20221227175704307

2、信息提交完毕,等待审核。

image-20221227175726147

注:在“移动应用”配置中,安卓打包时的签名和包名要确保无误

image-20221227175752200

网站应用创建流程

1、登录微信开放平台https://open.weixin.qq.com —>【管理中心】—>【网站应用】—>【创建】;

image-20221227175830982

2、填写网站授权回调域,提交审核即可。

image-20221227175848646

注:在“网站应用”配置中,授权回调域要配置好(api地址),否则PC 微信扫码登录功能用不了。

image-20221227175909132

绑定公众号流程

1、登录微信开放平台https://open.weixin.qq.com ->【管理中心】->【公众号】->【绑定公众号】;

image-20221227175935975

2、填写公众号登录邮箱、登录密码;

image-20221227175959368

3、使用公众号管理员微信号进行扫码验证,验证通过后,即绑定成功。

image-20221227180017997

image-20221227180028922

绑定小程序流程

1、登录微信开放平台https://open.weixin.qq.com ->【管理中心】->【小程序】->【绑定小程序】;

image-20221227180049418

2、填写小程序登录邮箱、登录密码;

image-20221227180109537

3、使用小程序管理员微信号进行扫码验证;验证通过后,即绑定成功。

image-20221227180125827

四、支付宝支付配置说明

1)应用ID(APPID)获取位置

想要得到 应用ID (APPID)需要先创建应用才可以

注意:如果有H5的网页应用,管理平台端支付宝支付参数这里要填H5网页应用对应的秘钥参数。

1、 创建应用

访问地址:https://open.alipay.com/ →控制台→创建应用(按需选择网页应用和移动应用,PC和H5对应网页应用,APP对应的是移动应用)

image-20221227192434006

填好网站信息,点击确认创建

创建网页应用

image-20221227192450420

创建移动应用

image-20221227192508876

2、 按需创建好应用之后,左侧就能看到该应用的 应用ID(APPID)

image-20221227192536024

如需实现某些功能,需要开通相应功能,状态是已签约之后才可以使用

image-20221227192555235

2)商户私钥(应用私钥)获取位置

1、设置 接口加签方式(密钥/证书)

image-20221227192628451

2、验证手机

image-20221227192653385

3、生成秘钥

获取支付宝官方秘钥生成器并安装或者直接用线上生成秘钥工具 https://opendocs.alipay.com/common/02khjo 注: 加签模式要选择 “公钥”!!

image-20221227192710543

4 推荐用 在线生成秘钥工具,点击生成并妥善保存好商户公钥(应用公钥)和商户私钥(应用私钥),一定要本地保存好!!

image-20221227192729601

5 复制这里的 应用私钥(商户私钥)并粘贴到我们的平台管理端这里

image-20221227192751485

3)支付宝公钥获取位置

1 将保存好的 应用公钥(商户公钥)复制准备好,粘贴到这里并保存

注:秘钥生成工具 生成出来的 应用公钥(商户公钥)是用来转换 支付宝公钥用的,千万别把这两个公钥弄混!

image-20221227192816962

2 此时就可以看到支付宝公钥了(妥善保存!)

image-20221227192833489

image-20221227192851975

网站应用的授权回调地址填这个:https://买家api地址/passport/account-binder/ALIPAY/callback

移动应用的授权回调地址填这个:https://m端访问地址/pages/auth/logining

2、设置白名单

进入微信公众账号--开发菜单--基本配置--IP白名单,将web项目所在的服务器的外网IP地址填写到IP白名单中,如果有多个,中间使用回车隔开。

image-20221227192919159

image-20221227192928553

3、微信公众号绑定开发者微信号

https://mp.weixin.qq.com/cgi-bin/frame?t=advanced/dev_tools_frame&nav=10049&token=1632769894&lang=zh_CN

image-20221227192951124

开发菜单 -->开发者工具 --> web开发者工具 --> 绑定开发者微信号

image-20221227193009210

image-20221227193019260

4、微信消息模板清理

模板消息→我的模板→删除

image-20221227193043581

2) 微信小程序配置

1、绑定微信公众号,开放平台

登录 微信小程序后台,设置---关联设置

image-20221227193109038

2、微信小程序添加项目/体验成员

https://mp.weixin.qq.com/wxamp/user/manage?action=index&use_role=1&token=784367483&lang=zh_CN

image-20221227193126865

image-20221227193137073

3、添加微信移动端客服

当微信移动端有客户咨询,这里绑定的微信号就可以收到并回复消息。

image-20221227193155323

4、微信小程序参数配置

https://mp.weixin.qq.com/wxamp/devprofile/get_profile?token=784367483&lang=zh_CN

在 “开发”菜单下-->“开发设置”

小程序appid和appsecret

image-20221227193211466

小程序代码上传秘钥和IP白名单

image-20221227193227953

小程序 服务器域名

分别将各个端api地址填好

uploadFile和downloadFile都加下oss域名(必须是https)

小程序生成海报前先配置域名,并且小程序已经上线,才能正常生成海报

image-20221227193249691

小程序 业务域名

这里填写wap端访问地址

image-20221227193304668

小程序添加插件

设置 菜单 --> 第三方设置 --> 插件管理

image-20221227193330874

3) 微信商户平台设置

微信商户平台需要开启的功能:

image-20221227193357828

1、配置支付授权目录/Native支付回调链接/H5支付域名

进入微信支付商户平台--产品中心--开发配置,修改公众号支付的支付授权目录,填写wap端域名。

Native支付回调链接 是 PC 扫码支付用到的 ,需要配置买家端api地址

注:一定要根据自己域名情况,区分好https或者http

H5支付域名 是主域名

image-20221227193422445

image-20221227193433247

image-20221227193442705

2、appid账号管理

关联不同类型的账号之后,才可以在不同端使用微信支付

image-20221227193504037

4) 微信开放平台设置

微信开放平台配置对应的是信任登录,不同端要分别创建不同应用,并且要通过认证和绑定好同一个微信商户号/公众号

image-20221227193519913

移动应用创建流程

登录微信开放平台https://open.weixin.qq.com ->【管理中心】->【移动应用】->【创建】,步骤如下:

1、填写应用基本信息,包括应用名、应用官网、下载地址等;

image-20221227193548415

2、信息提交完毕,等待审核。

image-20221227193606079

注:在“移动应用”配置中,安卓打包时的签名和包名要确保无误

image-20221227193622323

网站应用创建流程

1、登录微信开放平台https://open.weixin.qq.com —>【管理中心】—>【网站应用】—>【创建】;

image-20221227193653321

2、填写网站授权回调域,提交审核即可。

image-20221227193708584

注:在“网站应用”配置中,授权回调域要配置好(api地址),否则PC 微信扫码登录功能用不了。

image-20221227193729225

绑定公众号流程

1、登录微信开放平台https://open.weixin.qq.com ->【管理中心】->【公众号】->【绑定公众号】;

image-20221227193750264

2、填写公众号登录邮箱、登录密码;

image-20221227193808094

3、使用公众号管理员微信号进行扫码验证,验证通过后,即绑定成功。

image-20221227193828728

image-20221227193844039

绑定小程序流程

1、登录微信开放平台https://open.weixin.qq.com ->【管理中心】->【小程序】->【绑定小程序】;

image-20221227193920515

2、填写小程序登录邮箱、登录密码;

image-20221227193937476

3、使用小程序管理员微信号进行扫码验证;验证通过后,即绑定成功。

image-20221227194001312

五、常见问题