From 51be63a443be1235e2d00c5bc2cbff96c894c700 Mon Sep 17 00:00:00 2001 From: Administrator <450292408@qq.com> Date: Sat, 28 Aug 2021 03:55:47 +0000 Subject: [PATCH] docs: update wg-basic/wecaht --- wg-basic/wecaht.md | 62 +++++++++++++++++++++++++++++++++++++++------- 1 file changed, 53 insertions(+), 9 deletions(-) diff --git a/wg-basic/wecaht.md b/wg-basic/wecaht.md index c3d3cf0..be89ea8 100644 --- a/wg-basic/wecaht.md +++ b/wg-basic/wecaht.md @@ -2,7 +2,7 @@ title: 微信模块 description: 微信模块功能 published: true -date: 2021-08-28T03:21:57.635Z +date: 2021-08-28T03:55:45.960Z tags: wg-basic, wecaht editor: markdown dateCreated: 2021-08-26T08:21:24.080Z @@ -84,7 +84,7 @@ open-platform: ``` # 模块内功能 -## 1. 小程序 +## 1 小程序 ### 1.1 小程序登录 小程序的登录流程如下： @@ -97,7 +97,7 @@ open-platform: 6. 如果需要绑定用户手机号，则需要在获得用户授权之后，调用 `/app/miniapp/update-phone` 接口完成用户绑定，在拿到结果之后，重新获取 **token**。 > 这里需要说明的是：小程序默认登录时，会在系统创建随机账户，用户名密码都是随机的。当用户绑定过手机之后，会将随机的用户名修改为手机号。如果手机已经绑定，则提示失败，需要用户更换手机号或微信号。 -{.is-info} +> {.is-info} ### 1.2 更新个人信息 @@ -106,18 +106,62 @@ open-platform: > {.is-info} -## 2. 公众号 -## 3. 支付 + +## 2 公众号 + +暂无 + + + +## 3 支付 ### 3.1 发起预支付 用户在发起支付之前，需要调用后台系统接口来生成预支付订单，这个订单需要后台调用微信的预支付订单接口来完成。 目前，模块中只对微信支付调用实现了封装，并提供了 `ink.wgink.module.wechat.service.pay.v3.jsapi.IJsapiService` 接口来方便开发人员调用。开发人员只需要引入这个接口，调用 `placeOrder` 下单方法即可完成预支付订单的创建。 -### 3.2 实现支付被动通知业务 +### 3.2 监听支付回调 模块已经默认实现了支付的被动通知，但是，并没有做具体的业务，只是将通知结果进行了输出。开发人员如果想根据业务需要处理支付结果，可以实现 `ink.wgink.module.wechat.service.pay.v3.IPayNoticeService` 接口，并将实现业务类用 `@Primary` 注解标注。 -### 3.2 监听支付回调 - - ### 3.3 查询账单情况 + +模块提供查询账单的业务功能，开发人员可以引入 `ink.wgink.module.wechat.pojo.pay.v3.order.OrderSearch.IOrderSearchService` 接口，调用其中的方法完成订单查询。 + + + +# 提供的接口与方法 + +## API接口 + +详细接口内容请见系统接口文档 + +| 接口名称 | 说明 | +| ------------------------------------ | ---------------------- | +| /wechat/sign/default | 默认登录接口 | +| /app/miniapp/update-phone | 绑定手机接口 | +| /wechat/app/miniapp/user/update-info | 更新微信头像、昵称接口 | + + + +## 业务接口与方法 + +> ink.wgink.module.wechat.service.pay.v3.jsapi.IJsapiService + +| 方法 | 参数 | 说明 | 返回结果 | +| :-: | :-: | :-: | :-: | +| placeOrder | PayPlaceOrder | 预支订单内容，参数见微信支付文档，预支付接口 | 预支付交易会话标识，预支付交易会话标识。用于后续接口调用中使用，该值有效期在没有指定时2小时。还包括了小程序前端支付需要用到的参数。 | + +> ink.wgink.module.wechat.service.pay.v3.IPayNoticeService + +| 方法 | 参数 | 说明 | 返回结果 | +| :-: | :-: | :-: | :-: | +| handle | PayNoticeCiphertext | 解密后的密文，详情见微信支付文档回调接口 | 无 | + +> ink.wgink.module.wechat.pojo.pay.v3.order.OrderSearch.IOrderSearchService + +| 方法 | 参数 | 说明 | 返回结果 | +| :-: | :-: | :-: | :-: | +| getOrder | transactionId | 微信订单ID | 订单支付详情，详情见微信支付文档支付查询接口 | +| getBusinessOrder | businessOrderId | 自定义订单ID | 订单支付详情，详情见微信支付文档支付查询接口 | + +