parent
							
								
									a89ec9e744
								
							
						
					
					
						commit
						af7466eceb
					
				| 
						 | 
				
			
			@ -1,6 +1,7 @@
 | 
			
		|||
# pay-platform-channel-note
 | 
			
		||||
 | 
			
		||||
统一支付平台对接的渠道支付逻辑调研笔记,主要关注以下内容:
 | 
			
		||||
 | 
			
		||||
1. 合约
 | 
			
		||||
   1. 签约
 | 
			
		||||
   2. 签约查询
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -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 处理 异步通知
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
| 
						 | 
				
			
			@ -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: 完成合同签约
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
		Loading…
	
		Reference in New Issue