# 业务背景：
当前PayerMax业务中在全球支付方式的一、二级支付方式命名，不同国家规则不一致，且商务对外报价时也会有对同一类支付方式的命名差异，导致商户在对账，数据处理及支付对接过程中，有较高的理解成本。如下图案例，优化前在不同国家对信用卡的命名会同时出现：Debit/Credit Card、 Visa/MasterCard、或直接命名为Card；Wallet也可能存在E-wallet、Mobile Wallet，或直接命名Wallet等，同一类型却命名不同。

本次针对以上问题进行全球支付方式统一管理，内外部统一命名，同步修改账单记账逻辑，支付方式字段也由历史2个字段，扩展至3个字段，完成对账单的优化，方便商户对账和数据分析使用。

# 迭代后优势：
- 合同签约产品名称与账单内【支付方式 Payment Method】名称统一，对账更清晰
- 全球支付方式命名统一化，修正对支付方式类型定义，细化支付方式及目标机构管理，逻辑定义清晰明了，数据分析处理更便捷

# 一、 商户侧变化：
## MMC 商户平台
对全球支付方式命名信息统一，在各合约信息，订单查询模块下拉框、详情页、导出账单中对如下字段变更，详情如下：
### 1.【设置服务】-【信息管理】-【合同信息】-支付方式命名变更说明：
- 原支付方式展示与接口传参/合同签约支付方式可能不一致，优化后统一改为与合同签约产品一致
- 调整原有部分支付方式名称，比如将【Debit/Credit Card】调整为【Visa/Master Card】，完整列表请参考：[【新老版本支付方式映射表】](https://docs-server-sg.payermax.com/Public/Uploads/2023-07-17/新老版本支付方式映射表.pdf "[新老版本支付方式映射表.pdf")

原展示形式：
![](http://docs-server-sg.payermax.com/Public/Uploads/2023-07-11/64ad37c56186b.png)
新展示形式：
![](http://docs-server-sg.payermax.com/Public/Uploads/2023-07-11/64ad3803a56dc.png)
### 2.【收单管理】-【订单查询】-【支付方式】-下拉框/列表展示变更说明：
- 支付方式下拉框展示与合约命名保持一致

原展示形式：
![](http://docs-server-sg.payermax.com/Public/Uploads/2023-07-11/64ad39139ecd1.png)
新展示形式：
![](http://docs-server-sg.payermax.com/Public/Uploads/2023-07-11/64ad3924681c4.png)

### 3. 【收单管理】-【订单查询】-【订单详情】-详情展示变更说明：
原一级支付方式和二级支付方式定义逻辑与合同可能不一致，优化后不再使用一二级支付方式的表述，新增：
- 支付方式类型【Payment Method Type】，与接口传参paymentMethodType保持一致
- 支付方式【Payment Method】，与合同签约产品一致
- 目标机构/卡组【Target Org/Card Org】，与接口传参targetOrg/cardOrg保持一致

原展示形式：
![](http://docs-server-sg.payermax.com/Public/Uploads/2023-07-11/64ad39cdf2c6e.png)
新展示形式：
![](http://docs-server-sg.payermax.com/Public/Uploads/2023-07-11/64ad3a1482557.png)

其他同步涉及支付方式页面如：【收单管理】、【出款管理】、【争议管理】等涉及支付方式定义处，变更均同上

# 二、API传参逻辑变更

## 【收款服务】

### 1. 【收银台支付】
### 新版本API传参变更
线上已经集成无任何影响，不需要做任何改动，系统会自动匹配传参生成订单和账单；新增支付方式接入时需要按照最新文档进行集成，详见[【收银台支付-接口集成】](https://docs.payermax.com/202606-version/receipt/cashier/api-integration.md)

**变更内容：**
- 接口参数中，将入参字段paymentMethod修改为paymentMethodType，取值逻辑不变

**影响说明：**
- 线上已经集成的支付方式无影响，不需要重新集成
- 新接入支付方式，请使用paymentMethodType进行集成

### 2.【纯API支付】
详见[【纯API支付-接口集成】](https://docs.payermax.com/202606-version/receipt/direct-api/api-integration.md)

**变更内容：**
- Direct API将入参参数paymentMethod修改为paymentMethodType，取值逻辑不变

**影响说明：**
- 线上已经集成的支付方式无影响，不需要重新集成
- 新接入支付方式，请使用paymentMethodType进行集成

### 3.【回调通知】
详见[【异步通知】](https://docs.payermax.com/202606-version/receipt/result-notifications/callback-notification.md)

**变更内容：**
- 新增通知参数paymentMethodType，保留参数paymentMethod，两者取值逻辑相同

**影响说明：**
- 线上已经集成的支付方式，通知参数中会新增参数paymentMethodType，同时保留paymentMethod，两者取值逻辑相同
- 新接入支付方式，通知参数中新增参数paymentMethodType，不再返回paymentMethod参数
- 验签方式不变

### 4.【交易查询】
详见[【交易查询】](https://docs.payermax.com/202606-version/receipt/transaction-inquiry.md)

**变更内容：**
- 查询响应参数中使用paymentMethodType替换paymentMethod，两者取值逻辑相同

**影响说明：**
- 线上已经集成的支付方式，查询响应参数会新增参数paymentMethodType，同时保留paymentMethod，两者取值逻辑相同
- 新接入支付方式，查询响应参数会新增参数paymentMethodType，不再返回paymentMethod参数
- 验签方式不变

## 【出款服务】

详见[【API付款】](https://docs.payermax.com/202606-version/disbursement/request/api-request.md)

**变更内容：**
- 接口参数中，将入参字段paymentMethod修改为paymentMethodType，取值逻辑不变

**影响说明：**
- 线上已集成的支付方式无影响，不需要重新集成
- 新接入支付方式，请使用paymentMethodType

# 三、账单变更说明
删除两个字段：Payment Method、Sub Payment Method
>新增三个字段，展示形式：

| Payment Method Type | Payment Method | Target Org/Card Org |
| ------------------- | -------------- | ------------------- |
| 支付方式类型        | 支付方式       | 目标机构            |
| CARD                | VISA/MASTER    | VISA                |
| WALLET              | DANA           | DANA                |

- 支付方式类型【Payment Method Type】，与接口传参paymentMethodType保持一致
- 支付方式【Payment Method】，与合同签约产品一致，方便查看执行费率
- 目标机构/卡组【Target Org/Card Org】，与接口传参targetOrg/cardOrg保持一致

删除字段与新增字段映射关系表，请参见（仅展示有变更部分）:[【支付方式命名新老映射表】](https://docs-server-sg.payermax.com/Public/Uploads/2023-07-11/支付方式命名新老映射表.pdf "[支付方式命名新老映射表.pdf")

账单表头变更前后示例请参见：[【收款交易账单】](https://docs-server-sg.payermax.com/Public/Uploads/2023-07-18/收款交易账单V2.xlsx "[收款交易账单V2.xlsx")、
[【出款交易账单】](https://docs-server-sg.payermax.com/Public/Uploads/2023-07-18/出款交易单.xlsx "[出款交易单.xlsx")、
[【资金账单】](https://docs-server-sg.payermax.com/Public/Uploads/2023-07-18/资金账单新.xlsx "[资金账单新.xlsx")、
[【结算明细单】](https://docs-server-sg.payermax.com/Public/Uploads/2023-09-01/结算明细单.xlsx "[结算明细单.xlsx")、
[【结算汇总单】](https://docs-server-sg.payermax.com/Public/Uploads/2023-09-01/%E7%BB%93%E7%AE%97%E6%B1%87%E6%80%BB%E5%8D%95-%20Sum%20Settle.xlsx)
<I>

提示：如果使用程序自动解析账单对账，请对文件解析程序并进行改造。

</I>