开发指引

更新时间:2024.11.18

1. 接口规则

为了在保证支付安全的前提下,带给商户简单、一致且易用的开发体验,我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考APIv3接口规则

2. 开发准备

2.1. 搭建和配置开发环境

开发者应当依据自身的编程语言来构建并配置相应的开发环境。

3. 快速接入

3.1. 业务流程图

步骤一 用户在商户小程序中点击签约,商户后台系统查询用户是否已经签约,若未签约调用微信后台系统的《预签约》接口获取预签约码。

步骤二 商户小程序(带预签约码参数)跳转到《小程序调起校园轻松付-签约服务》完成授权和签约

步骤三 签约成功后,微信支付会异步将签约信息通知给商户,同时商户可以主动在《通过协议号查询签约》查询用户签约信息

步骤四 签约后商户通过《扣款》接口发起扣款请求,订单受理之后直接返回,商户可以根据微信支付回调确定订单状态。或主动(通过《微信订单号》和《商户订单号》)查询订单状态;

注意

  • 同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。 推荐的做法是,当商户系统收到通知进行处理时,先检查对应业务数据的状态,并判断该通知是否已经处理。如果未处理,则再进行处理;如果已处理,则直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。

  • 如果在所有通知频率(1/60/60/60/60/60/60/60/60/60/60/300/300/300/300/300/300/300/300/300/300/(单位:秒))后没有收到微信侧回调,商户应调用查询订单接口确认订单状态。

特别提醒:

  1. 商户系统对于确认订单通知的内容一定要做签名验证,并校验通知的信息是否与商户侧的信息一致,防止数据泄露导致出现“假通知”,造成资金损失。

  2. 当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。

反馈
咨询
目录
置顶