微信公众号支付接口文档,微信支付服务商文档中心

2024-02-15
来源:网络整理

1. 接口规则

为了在保证支付安全的同时,为商户提供简单、一致、易用的开发体验,我们推出了全新的微信支付接口。 本版本API具体规则请参见接口规则。

2、开发准备 2.1. 设置和配置开发环境

为了帮助开发者调用开放接口,我们提供了JAVA、PHP、GO三种语言的开发库,封装了签名生成、签名验证、敏感信息加解密、媒体文件上传等基本功能(更多语言版本)开发库将在不久的将来提供)。

测试步骤:

1.根据自己的开发语言,选择对应的开发库并构建项目。 具体配置请参考下面链接中的详细说明:

-php(新)(推荐),--(新),适合PHP开发人员。 -go(新),适用于 Go 开发人员。

更多资源请前往微信支付开发者社区(新)搜索查看。

2. 创建加载商户私钥、加载平台证书、初始化的通用方法。

示例代码

3. 根据接口示例代码,替换请求参数后即可发起测试。

阐明:

签名生成 签名验证 敏感信息加解密(私钥)s(平台证书)(V3密钥) 2.2. 业务开发配置 2.2.1. 设置支付目录

1.支付授权目录说明:

1.支付授权目录说明:

1)服务商最后一次请求发起微信支付结账的页面地址称为“支付授权目录”。 例如:(new)的支付授权目录为:(new)。

2)服务商实际支付授权目录必须与微信支付服务商平台设置的一致,否则会报错“当前页面的URL未注册:”。

3)服务商模式支付授权目录设置可分为两种方法:

2.支付授权目录设置说明:

1)服务商为所有子商户建立支付授权目录

登录微信支付【服务商平台(新)->产品中心->开发配置],设置一般会在5分钟内生效。

微信公众号支付接口文档_微信公众平台接口文档_微信公众号调用微信支付

2)服务提供商为某个子商户建立单独的支付授权目录。

登录微信支付【服务商平台(新)->服务商功能->特约商户管理],设置一般会在5分钟内生效。

微信公众平台接口文档_微信公众号支付接口文档_微信公众号调用微信支付

3、支付授权目录验证规则说明:

2.2.2. 设置授权域名

微信公众平台接口文档_微信公众号调用微信支付_微信公众号支付接口文档

微信公众平台接口文档_微信公众号调用微信支付_微信公众号支付接口文档

3. 快速访问 3.1. 业务流程图

微信公众平台接口文档_微信公众号调用微信支付_微信公众号支付接口文档

关键步骤:

步骤3 用户下单发起支付,商户可以通过下单创建支付订单。

步骤8:商户可以通过微信浏览器调用支付接口激活微信支付,并发起支付请求。

步骤15 用户支付成功后,商户可以收到微信支付支付结果通知接口。

步骤20 如果商户没有收到微信支付结果通知,则需要主动调用查询订单接口查询支付结果。

3.2. API访问(包括示例代码)

文档展示了如何使用微信支付服务器SDK快速接入支付并完成与微信支付的接口。

注意

3.2.1. [服务器] 下订单

步骤说明:

用户通过商户下发的模板消息或扫描二维码在微信中进入商户网页。 当用户选择相关商户进行购买时,商户系统首先调用该接口在微信支付服务后台生成预付款交易订单。

示例代码

重要输入说明:

更多参数、响应详情和错误码请参考订单接口文档。

3.2.2. [客户] 电话付款

步骤说明:通过订单接口成功获取预付款交易 ID()后,需要调用支付接口调用微信支付收银。

注意

请保证实际支付时请求的目录与后台配置的目录一致(目前支持配置根目录,配置后有一定的生效时间,一般在5分钟内),否则微信支付会无法成功引发。 请参阅配置详细信息。 内置对象在其他浏览器中无效。 wx. pay,格式内容参考。 分步说明的链接地址是。 调用支付返回的res对象的驼峰格式为返回格式。 如果商家采用不同的方式,这里需要注意响应的字符大小写和格式。

示例代码

重要输入说明:

生成规则、响应详情和错误码请参考支付接口文档。

3.2.3. [服务器]接收支付结果通知

步骤描述:当用户完成支付后,微信会通过异步回调的方式通知商户相关支付结果。 商户需要按照文档规范接收处理并返回响应。

注意

特别提醒:商户系统必须对结果通知的内容进行签名验证,并验证通知中的信息与商户侧的信息是否一致,防止数据泄露导致“假通知”和财务损失。

更多参数、响应详情和错误码请参考支付结果通知支付通知API接口文档。

3.2.4. [服务器]查询订单

步骤描述:当商户后台、网络、服务器等出现异常,商户系统未收到支付通知时,商户可以通过订单查询接口验证订单支付状态。

注意

可以通过微信支付订单号和商户订单号查询订单。 两种查询方法返回相同的结果。

需要调用查询接口的情况:

示例代码

更多参数、响应详情及错误码请参考微信支付订单号/商户订单号接口文档。

3.2.5. [服务器]关闭订单

步骤描述:当商户订单支付失败时,需要生成新的订单号才能重新发起支付。 下单后必须调用关闭原订单号,避免重复付款。 系统下单后,用户付款超时,系统退出,不再接受,阻止用户继续。 请调用自定义订单接口。

注意

示例代码:

示例代码

更多参数、响应详情及错误码请参考平仓接口文档

3.2.6. [服务器]申请交易账单

步骤说明:微信支付每天都会提供交易账单文件,商户可以通过该接口获取账单文件的下载地址。

示例代码

更多参数、响应详情及错误码请参考应用交易账单接口文档

3.2.7. [服务器]下载账单

步骤描述:通过应用交易账单接口获取账单下载地址()后,通过该接口获取对应的账单文件。 该文件包含金额、时间、营销等交易相关信息,供商户查询订单、退款、银行账户到账等。

注意

示例代码

更多参数、响应详情和错误码请参考下载账单接口文档。

4.常见问题 Q:界面报“此公众号没有这些权限,错误代码”,如下图

微信公众平台接口文档_微信公众号支付接口文档_微信公众号调用微信支付

答:请按照以下步骤排除故障:

建议查看公众号的功能。 例如,您是否尝试在订阅号/未认证的公众号中调用认证服务号功能? 检查证明是否过期或填写错误。 请尝试使用授权登录方式。 Q:调用支付接口时,提示“该商户暂无该交易权限,请联系商户客服”。

微信公众号调用微信支付_微信公众平台接口文档_微信公众号支付接口文档

答:请按照以下步骤排除故障:

请检查您的订单接口是否已指定支付用户身份。 该功能需要单独开通指定身份支付权限才可以使用。 请确认您使用的商户账户是否有支付权限。 您可以登录商户平台-产品中心查看。 Q:调用支付接口时,提示“当前页面的URL未注册”。

微信公众号调用微信支付_微信公众号支付接口文档_微信公众平台接口文档

A:请检查订单接口中使用的商户号是否在服务商平台上配置了对应的支付目录(新)。 请参阅“”章节中的说明。

Q:界面报“域名与后台配置不一致,错误码:”

微信公众号支付接口文档_微信公众平台接口文档_微信公众号调用微信支付

答:请按照以下步骤排除故障:

检查下单接口和获取接口是否相同(需要一致)。 检查对应的公众号后台(新增),查看配置的授权域名与获取的域名是否一致。 授权域名配置路径:【公共平台(新)->设置->公众号设置->功能设置->网页授权域名]。 Q:调用支付接口时,提示“该商户暂不支持通过外部微信完成支付”。

微信公众号调用微信支付_微信公众号支付接口文档_微信公众平台接口文档

A:支付只能通过微信浏览器发起。

分享