diff --git a/README.md b/README.md index e3f1414..e44d8f2 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ # pay-platform-channel-note 统一支付平台对接的渠道支付逻辑调研笔记,主要关注以下内容: + 1. 合约 1. 签约 2. 签约查询 @@ -13,4 +14,4 @@ 3. 退款 4. 退款查询 5. 处理 异步通知 -每个支付渠道单独建立自己的分支, 区别管理 \ No newline at end of file + 每个支付渠道单独建立自己的分支, 区别管理 diff --git a/ant.md b/ant.md new file mode 100644 index 0000000..b2def1c --- /dev/null +++ b/ant.md @@ -0,0 +1,52 @@ +# 蚂蚁租赁平台相关调研笔记 + +## 0. SDK + +> 官方描述 +> 本产品通过蚂蚁链网关统一对外提供 API 服务,网关提供统一的 SDK,客户引入使用即可。同时调用 API 的 Client 统一申明即可,Client 初始化一次即可,然后可以调用不同接口,Client 不需要每个接口都初始化一个 Client,Client 创建会占用线程池及网络建链,相对耗时,因此一次性创建使用即可 + +- SDK: +- 官方有提供 golang 相关 SDK 引入即可 +- Golang + +```bash + ## 需要安装 go,依赖指令如下({version}为版本号) + + ## https://github.com/antchain-openapi-sdk-go/ato + + go get github.com/antchain-openapi-sdk-go/ato@{version} +``` + +## 1. 合约 + +### 1.1 签约 + +1. 前置准备 + 1. 商户进件 + 2. 参考 雷神账号 后台管理界面 + +### 1.2 签约查询 + +### 1.3 解约 + +### 1.4 解约查询 + +### 1.5 处理 异步通知 + +--- + +## 2. 订单支付 + +### 2.1 支付扣款 + +### 2.2 支付扣款查询 + +### 2.3 退款 + +### 2.4 退款查询 + +### 2.5 处理 异步通知 + +``` + +``` diff --git a/业务流程.md b/业务流程.md new file mode 100644 index 0000000..7a842d8 --- /dev/null +++ b/业务流程.md @@ -0,0 +1,290 @@ +# 蚂蚁租赁业务流程梳理 + +> 根据项目需求,裁剪官方部分流程(官方多流程处理时),按照项目具体需求按需选取 + +## 1. 前置订单签约 + +### 1.1 发起合同签约 + +```mermaid + sequenceDiagram + Actor u as 新老系统 + participant p as 统一支付平台 + participant a as 蚂蚁 + + note over u,a: 签约流程【前置订单签约】 + + p->>a: 同步前置订单 + + p->>a: 发起前置合同签署 + + p->>a: 发起代扣签约请求 + + p->>a: 查询代扣签约结果 + + p->>a: 代扣签约完成后,落签合同 + + p->>a: 如果需要多方落签的情况 + + +``` + +### 1.1.1 发起代扣签约 + +> 归属于具体订单 + +```mermaid + sequenceDiagram + Actor u as 新老系统 + participant p as 统一支付平台 + participant a as 蚂蚁 + + + u->>+p: 发起代扣签约请求 + + p->>+p: 开始组装请求 + + p->>p: 填写订单号 + + p->>-p: 组装请求完成 + + p->>+a: 发送代扣签约请求 + + a-->>-p: 响应代扣签约结果 + p->>-u: 响应代扣签约结果 + + + +``` + +### 1.1.2 发起解除代扣 + +> 归属于具体订单 + +```mermaid + sequenceDiagram + Actor u as 新老系统 + participant p as 统一支付平台 + participant a as 蚂蚁 + + u->>+p: 发起解除代扣请求 + + p->>+p: 开始组装请求 + + p->>p: 填写订单号 + + p->>-p: 组装请求完成 + + p->>+a: 发送解除代扣请求 + + a-->>-p: 响应解除结果 + p->>-u: 响应解除结果 + +``` + +### 1.1.3 查询代扣签约 + +> 归属于具体订单 + +```mermaid + sequenceDiagram + Actor u as 新老系统 + participant p as 统一支付平台 + participant a as 蚂蚁 + + + u->>+p: 发起查询代扣签约请求 + + p->>+p: 开始组装请求 + + p->>p: 填写订单号 + + p->>-p: 组装请求完成 + + p->>+a: 发送查询代扣签约请求 + + a-->>-p: 响应查询代扣签约结果 + p->>-u: 响应查询代扣签约结果 + + + +``` + +### 1.1.4 取消代扣计划 + +> 归属于具体订单 + +```mermaid + sequenceDiagram + Actor u as 新老系统 + participant p as 统一支付平台 + participant a as 蚂蚁 + + + u->>+p: 发起取消代扣签约请求 + p->>+p: 开始组装请求 + + p->>p: 填写订单号 + p->>p: 填写取消理由 + + p->>-p: 组装请求完成 + p->>+a: 发送取消代扣签约请求 + + a-->>-p: 响应取消代扣签约结果 + p->>-u: 响应取消代扣签约结果 + + + +``` + +### 1.1.5 异步解约确认 + +> 归属于具体订单 + +```mermaid + sequenceDiagram + Actor u as 新老系统 + participant p as 统一支付平台 + participant a as 蚂蚁 + + + u->>+p: 发起异步解约确认请求 + p->>+p: 开始组装请求 + + p->>p: 填写订单号 + p->>p: 填写操作 == "REFUSE" + p->>p: 填写 服务用户 + p->>p: 填写 用户欠款 + p->>p: 填写 解约理由 + + + p->>-p: 组装请求完成 + p->>+a: 发送异步解约确认请求 + + a-->>-p: 响应异步解约确认结果 + p->>-u: 响应异步解约确认结果 + + + +``` + +### 1.1.6 查询订单信息 + +> 归属于具体订单 + +```mermaid + sequenceDiagram + Actor u as 新老系统 + participant p as 统一支付平台 + participant a as 蚂蚁 + + + u->>+p: 发起查询订单信息请求 + p->>+p: 开始组装请求 + + p->>p: 填写 查询类型("orderFullInfo") + p->>p: 填写 订单号 + + + p->>-p: 组装请求完成 + p->>+a: 发送查询订单信息请求 + + a-->>-p: 响应查询订单信息结果 + p->>-u: 响应查询订单信息结果 + + +``` + +### 1.11.1 同步前置订单 + +```mermaid + sequenceDiagram + + participant p as 统一支付平台 + participant a as 蚂蚁 + + + + p->>+p: 开始组装请求 + + p->>p: 填写 查询类型("orderFullInfo") + p->>p: 填写 订单号 + + + note left of p: 这样填写数据, 订单更类似我们统一支付平台的合约概念 + p->>p: 填写 租赁期数 + p->>p: 填写 总金额 + + p->>-p: 组装请求完成 + p->>+a: 发送查询订单信息请求 + + a-->>-p: 响应查询订单信息结果 + + + +``` + +### 1.9.1 关闭订单 + +> 归属于具体订单 +> +> 关闭订单的前提: +> +> 1. 用户履约完成 +> 2. 取消代扣计划:场景 +> 2.1 租转售 +> 2.2 退租成功 + +```mermaid + sequenceDiagram + + Actor u as 新老系统 + participant p as 统一支付平台 + participant a as 蚂蚁 + + + u->>+p: 发起关闭订单请求 + + p->>+p: 开始组装交易同步请求 + p->>p: 填写订单号, 关闭原因 + p->>-p: 组装交易同步请求完成 + + p->>+a: 发送关闭订单请求 + a-->>-p: 响应关闭结果 + + + + p->>-u: 响应关闭结果 + + + + +``` + +## 2. 合约 + +### 2.1 签约 + +> 前置签约模式 + +```mermaid + sequenceDiagram + Actor u as 新老系统 + participant p as 统一支付平台 + participant a as 蚂蚁 + + u->>p: 签署合同请求 + p ->>+a: 发起合同申请 + + p ->>a: 调用前置签约合同接口 + p ->>a: 填写参数 合同模板ID、订单ID【统一平台的合约ID】 + + a->>a: 合同校验 + a->>p: 合同校验完成后,返回签约链接地址 + p->>u: 透传签约链接,在用户界面拉起合同界面 + u->>a: 签署合同完毕 + + a ->>-p: 完成合同签约 + + +```