专注于高性能网络应用开发,核心技术包括PHP、Java、GO、NodeJS等后端语言,VUE、UNI、APP等前端开发,服务器运维、数据库、实时通信、AI等领域拥有丰富经验

2025年最新微信支付及支付宝支付接入全攻略

微信支付接入一般所需内容

  • 微信支付-商户账号
  • API证书
  • 关联相关应用
  • 开通支付产品

微信支付接入

  1. 准备 微信支付-商户账号。 注册页面:https://pay.weixin.qq.com/index.php/apply/applyment_home/guide_normal
    1.BDwnU0iS.png
    登录页面:https://pay.weixin.qq.com/index.php
    2.CVQLr7iq.png
  2. 申请API证书 菜单路径:账户中心-API安全-申请API证书/管理
    123.BgeZFrix.jpg

    使用场景

    • APIv2 中,调用微信支付安全级别较高的接口(如:退款、企业红包、企业付款)
    • APIv3 中,调用微信支付所有接口

    2.1、登录【微信支付商户平台 - 账户中心 - 账户设置 - API安全 - 申请API证书】申请证书,确定后请勿关闭页面
    c1.png
    c2.png
    2.2、点击下载证书工具;下载后,双击“WXCertUtil.exe”文件,选择安装路径后,点击申请证书
    也可通过以下链接下载证书工具:
    windows版本 :https://wx.gtimg.com/mch/files/WXCertUtil.exe
    mac版本 :https://wx.gtimg.com/mch/files/WXCertUtil.dmg
    c3.png
    2.3、在【证书工具】,填写商户号信息(商户号、商户名称),点击下一步
    c4.png
    2.4、在【证书工具】,复制证书请求串
    (若提示"请粘贴请求串到商户平台获取证书串",请在第2.5点步骤检查是否已粘贴。可同时尝试手动鼠标复制粘贴的方法)
    c5.png
    2.5、在【商户平台】,粘贴证书请求串
    c6.png
    2.6、在【商户平台】,输入操作密码,安全验证后生成证书串
    c7.png
    2.7、在【商户平台】,复制证书串
    c8.png
    2.8、在【证书工具】,粘贴证书串,点击下一步,申请证书成功
    (若提示"证书与本地公私钥不匹配",可能是浏览器禁用了剪切板复制功能。请在操作步骤第7点,操作时使用鼠标选中全部证书串内容(注意右边有下拉框),单击鼠标右键选择复制)
    c9.png
    c10.png

  3. 设置APIV3密钥 菜单路径:账户中心-API安全-设置APIv3密钥
    4.Cwf-dNfq.png
  4. 关联应用 菜单路径:产品中心-AppID账号管理
    5.BmnBjdMi.png
  5. 开通支付产品 菜单路径:产品中心-我的产品
    6.D_WvmOG5.png
    支付场景对应的APPID
    7.C-Juw02X.png

一、支付场景与对应产品配置

不同业务场景需开通对应的微信支付产品,并配置专属应用ID,具体如下:

支付场景对应支付产品需配置的应用ID说明
微信公众号商城JSAPI支付JSAPI支付应用ID在微信公众号内完成的支付(如公众号内商品购买、服务付费)
PC商城Native支付Native支付应用IDPC端网页生成支付二维码,用户使用微信扫码完成支付
微信小程序小程序支付小程序支付应用ID在微信小程序内完成的支付(如小程序内商品购买、会员充值)
手机网页(非微信内)H5支付H5支付应用ID手机浏览器网页(非微信环境)跳转微信支付(如外部浏览器打开的商城网页)
APP(iOS/AndroidAPP支付APP支付应用ID在已安装的APP内调用微信支付(如APP内下单支付)

二、通用参数配置说明(所有支付方式均需配置)

以下参数为所有支付场景的基础配置项,需提前在微信支付后台获取并填写:

参数名称作用说明获取/填写方式
商户号微信支付商户的唯一标识(由微信支付分配)微信支付后台路径:账号中心 > 个人信息 > 登录账号(查看“商户号”字段)
APIv3密钥调用微信支付APIv3接口时的加密密钥(用于签名、验签)微信支付后台路径:账号中心 > API安全 > 设置APIv3密钥(按页面指引操作设置)
API证书-证书序列号商户API证书的唯一标识(用于验证商户身份)微信支付后台路径:账号中心 > API安全 > 管理证书(查看对应证书的序列号)
apiclient_key客户端私钥文件(用于签名请求,需填写文件完整内容)从下载的“商户API证书”压缩包中获取apiclient_key.pem文件,复制文件全部内容
加签方式平台身份验证方式(如“证书加签”“密钥加签”,按后台实际选择填写)微信支付后台路径:账户中心 > API安全 > 验证微信支付身份(查看当前加签方式)
支付回调域名接收微信支付结果通知的服务器地址(需确保可公网访问)填写自己网站的回调地址(如:https://lvtao.net/pay/wepay/notify

三、证书方式加签额外参数(若加签方式选择“证书加签”需配置)

若加签方式为“证书加签”(即使用微信支付平台证书验证身份),需额外配置以下参数:

参数名称作用说明获取/填写方式
公钥证书ID微信支付平台公钥的唯一标识(用于验证平台身份)微信支付后台路径:账户中心 > API安全 > 平台证书管理(获取平台公钥证书ID)
公钥证书微信支付平台公钥文件内容(用于验证回调请求的真实性)从微信支付后台下载平台公钥证书文件,复制文件全部内容

支付宝支付

所需内容

  • 支付宝-商家账号
  • 支付证书
  • 开通支付产品
  • 关联支付产品
  1. 准备 支付宝-商家账号。
    注册页面:https://certifyweb.alipay.com/certify/reg/guide#/
    1.Bx532AUz.png
    登录页面:https://b.alipay.com/page/portal/home
    2.4HnF7upH.png
  2. 开通支付产品 位置:产品中心
    3.CNcIJ6bt.png

    • 电脑网页:当面付
    • APP:APP支付
    • 手机网页:手机网站支付
  3. 应用关联支付产品
    进入支付宝开放平台:https://open.alipay.com
    创建/进入应用
    4.BNvLzPAl.png
    绑定所需的支付产品
    5.BcXNGWv7.png
  4. 申请证书
    进入开发设置页面,设置证书
    6.CesDIeDZ.png
    证书操作指南:https://opendocs.alipay.com/common/056zub?pathHash=91c49771

一、支付场景与对应产品配置

不同业务场景需开通对应的支付宝支付产品,并配置专属应用ID(APPID),具体如下:

支付场景对应支付产品需配置的APPID说明
支付宝小程序小程序支付小程序支付APPID在支付宝小程序内完成的支付(如小程序内商品购买、服务付费)
手机网页(非支付宝内)手机网站支付手机网站支付APPID手机浏览器网页(非支付宝环境)跳转支付宝支付(如外部浏览器打开的商城)
APP(iOS/Android)APP支付APP支付APPID在已安装的APP内调用支付宝支付(如APP内下单支付)
PC网页电脑网站支付电脑网站支付APPIDPC端网页生成支付二维码,用户使用支付宝扫码完成支付
线下实体店/扫码设备当面付(扫码支付)当面付APPID线下场景用户扫码支付(如门店收银台、自助设备)

二、通用参数配置说明(所有支付方式均需配置)

以下参数为所有支付场景的基础配置项,需提前在支付宝开放平台获取并填写:

参数名称作用说明获取/填写方式
商户号(PID)支付宝商户的唯一标识(由支付宝分配)支付宝开放平台路径:商家中心 > 账户信息 > 商户信息(查看“支付宝商户号”)
应用ID(APPID)支付宝应用的唯一标识(每个支付产品对应独立APPID)支付宝开放平台路径:开发者中心 > 我的应用(选择对应支付产品应用查看APPID)
应用私钥(private_key)开发者生成的私钥(用于签名请求,需填写完整内容)通过支付宝开放平台提供的密钥工具生成(或使用OpenSSL生成),复制私钥文件内容(无注释)
支付宝公钥(alipay_public_key)支付宝提供的公钥(用于验证回调签名)支付宝开放平台路径:开发者中心 > 我的应用 > 应用公钥(上传应用公钥后,支付宝自动生成对应的“支付宝公钥”,复制即可)
支付回调地址(notify_url)接收支付宝支付结果通知的服务器地址(需可公网访问)填写你网站的支付宝回调地址(如:https://lvtao.net/pay/alipay/notify
页面跳转地址(return_url)支付完成后用户跳转的页面(可选,建议配置)填写你网站的支付宝跳转地址(如:https://lvtao.net/pay/alipay/return

三、证书方式加签额外参数(若使用证书加签需配置)

若安全要求较高,可选择证书加签(替代普通公私钥加签),需额外配置以下参数:

参数名称作用说明获取/填写方式
应用公钥证书(app_cert_cert)开发者上传的应用公钥证书文件(用于验证开发者身份)支付宝开放平台路径:开发者中心 > 我的应用 > 加签方式 > 证书(上传应用公钥证书后下载,复制文件内容)
支付宝公钥证书(alipay_cert_cert)支付宝提供的公钥证书文件(用于验证支付宝身份)支付宝开放平台路径:开发者中心 > 我的应用 > 加签方式 > 证书(下载“支付宝公钥证书”,复制文件内容)
根证书(root_cert_cert)支付宝根证书文件(用于验证证书链)支付宝开放平台路径:开发者中心 > 我的应用 > 加签方式 > 证书(下载“根证书”,复制文件内容)

相关文章

macOS下使用mkcert创建本地HTTPS证书完全指南

在Web开发过程中,我们经常需要在本地环境中测试HTTPS功能。传统的自签名证书会导致浏览器显示不安全警告,影响开发体验和测试结果。而公共证书服务(如Let's Encrypt)不适合本地开发使...