微信支付-小程序开放服务,基于普通商户身份,提供直连模式-小程序基础支付接口能力,包括 JSAPI 下单、查询订单、小程序调起支付、申请退款、查询退款、申请交易账单等。
创建微信支付-小程序
准备工作
注意
创建服务前,需要准备好一个非个人主体微信小程序以及微信支付普通商户号,两者提前做好绑定。
相关帮助文档:
步骤1:新建服务
在云开发管理系统内,编辑低码应用时,进入数据源 > APIs,选择新建微信支付-小程序服务。
步骤2:参数配置
配置接口调用依赖的参数,包括 AppID、支付商户号、商户 API 证书序列号(什么是商户 API 证书以及如何获取)、商户 API 私钥(API 证书及密钥)、API V3 密钥(什么是 API V3 密钥)。
说明:
APIs 默认的支付方法,本质是对微信支付平台方法的封装。创建 APIs 服务配置好参数,后续支付方法调用时,会帮助开发者自动录入字段或完成加解密,减少重复工作。
对比微信支付原有接口,APIs 支付服务做了简化与封装,如下图所示小程序支付-小程序下单接口与 APIs 服务-JSAPI 下单对比,APIs 服务接口无需传入 appid 和商户号。
APIs 接口参数。
通知回调配置,是为小程序支付中 JSAPI 和 申请退款 接口配置回调通知 URL,支付/退款操作结果会通过该通知地址反馈给调用方,完成业务状态的更新。
小程序支付通知回调支持工作流创建和开发者自有服务两种配置方式。 注意
微搭低码平台暂时仅支持配置自有服务,云开发管理系统支持两种通知回调方式。
其中工作流创建方式依赖云开发工作流功能模块,在云开发管理系统内开发者可以选择创建新的工作流或者选择已有工作流。
开发者自有服务支持录入自行搭建的回调地址,进而兼容开发者已有服务。
注意:
统一下单和申请退款的链接需要填写完整的页面路径,应包含前缀
https://
。步骤3:方法使用
创建好小程序支付服务后,支持在 微搭低码平台 和云开发管理系统中使用。云开发管理系统入口为:微信开发者工具 > 云开发控制台 > 更多 > 管理工具。
选择应用进入低代码编辑页 > 数据源 > APIs,创建/查看小程序支付,具体用法请参见 小程序支付管理模板 和 小程序直连支付功能展示。支持低码开发时调用小程序支付接口,完成相关业务搭建。
注意:
在微搭编辑器预览区无法测试支付功能,需要发布到小程序后,使用真实的手机测试。
步骤4:编辑修改
小程序支付方法中,支持对 JSAPI 下单和申请退款接口配置回调地址。选中对应方法,单击编辑后,对回调地址进行修改,修改完成后单击保存。
单击编辑后对基本信息和参数配置进行修改。
步骤5:处理回调信息
对于工作流回调地址,支持跳转至工作流编辑器,对支付/退款通知结果进行处理,例如根据支付结果更新支付和订单状态。
进入工作流编辑器,接收回调后完成业务逻辑,请参见 工作流处理支付回调文档。
至此,已经完成小程序微信支付服务的创建,详细关联业务用法请参见 小程序支付管理模板、小程序直连支付功能展示 和 微信支付事件工作流 开发文档。