Compare commits

..

2 Commits
main ... ant

Author SHA1 Message Date
SevenLion cc9a9e2221 feat(require): SDK使用相关参数 2025-01-03 18:33:07 +08:00
SevenLion af7466eceb feat(ant): 蚂蚁租赁业务调研
1. 基本流程调研
2. 相关业务流程记录
2025-01-03 18:29:14 +08:00
4 changed files with 351 additions and 1 deletions

View File

@ -1,6 +1,7 @@
# pay-platform-channel-note
统一支付平台对接的渠道支付逻辑调研笔记,主要关注以下内容:
1. 合约
1. 签约
2. 签约查询
@ -13,4 +14,4 @@
3. 退款
4. 退款查询
5. 处理 异步通知
每个支付渠道单独建立自己的分支, 区别管理
每个支付渠道单独建立自己的分支, 区别管理

52
ant.md Normal file
View File

@ -0,0 +1,52 @@
# 蚂蚁租赁平台相关调研笔记
## 0. SDK
> 官方描述
> 本产品通过蚂蚁链网关统一对外提供 API 服务,网关提供统一的 SDK客户引入使用即可。同时调用 API 的 Client 统一申明即可Client 初始化一次即可然后可以调用不同接口Client 不需要每个接口都初始化一个 ClientClient 创建会占用线程池及网络建链,相对耗时,因此一次性创建使用即可
- 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 处理 异步通知
```
```

7
sdk-使用物料.md Normal file
View File

@ -0,0 +1,7 @@
# Ant SDK 使用参数需求
1. 网关地址及环境
1. 差异化接口是否独有环境
2. AK/SK
3. 请求协议
4. 测试相关沙箱环境

290
业务流程.md Normal file
View File

@ -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: 完成合同签约
```