业务背景：

当前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】，完整列表请参考：【新老版本支付方式映射表】

原展示形式： 新展示形式：

2.【收单管理】-【订单查询】-【支付方式】-下拉框/列表展示变更说明：

• 支付方式下拉框展示与合约命名保持一致

原展示形式：
新展示形式：

3. 【收单管理】-【订单查询】-【订单详情】-详情展示变更说明：

原一级支付方式和二级支付方式定义逻辑与合同可能不一致，优化后不再使用一二级支付方式的表述，新增：

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

原展示形式： 新展示形式：

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

二、API传参逻辑变更

【收款服务】

1. 【API收款】

线上已经集成无任何影响，不需要做任何改动，系统会自动匹配传参生成订单和账单；如果已集成的商户，需要对接新的支付方式，则按照最新官网文档进行传参，详见【收款请求-API收款】

变更内容：

• 入参参数去掉paymentType参数
• 入参参数新增字段：paymentMethodType、targetOrg、cardOrg

影响说明：

• 线上已集成的支付方式无影响，不需要重新集成；
• 新接入支付方式，请使用paymentMethodType、targetOrg、cardOrg进行集成，新老支付方式映射请参考：支付方式映射关系

2.【订单查询结果】

详见【查询结果】

变更内容：

• 升级接口版本，version传参为2.7
• 响应参数中新增字段：paymentMethodType、targetOrg、cardInfo.cardOrg
• 不再返回paymentType参数，paymentType与paymentMethodType、targetOrg、cardOrg的映射关系请参考:支付方式映射关系

影响说明：

• 线上已集成的支付方式无影响，不需要重新集成，如果需要返回新增的参数，调用查询订单API接口时，请将version修改为2.7
• 新集成的支付方式，请求入参version字段传2.7时，将返回官网中的所有字段
• 验签方式

3.【异步回调通知】

详见【异步回调通知】

变更内容：

• 通知参数中新增参数：paymentMethodType、targetOrg、cardInfo字段，其中cardInfo为String类型，格式为json格式：

{
  "cardIdentifierName":"*D",
  "cardIdentifierNo":"520000******0007",
  "cardOrg":"MASTERCARD"
}

影响说明：

• 线上已集成的商户无影响，如果商户需要新增的通知参数，需要商户联系我方技术支持进行通知版本升级，升级后不再返回paymentType参数，同时新增paymentMethodType、targetOrg、cardInfo等参数
• paymentType与paymentMethodType、targetOrg、cardOrg的映射关系请参考：支付方式映射关系
• 验签方式

【出款服务】

详见【API付款】

变更内容：

• 入参参数去掉payType参数
• 入参参数新增字段：paymentMethodType、targetOrg

影响说明：

• 线上已集成的支付方式无影响，不需要重新集成；
• 新接入支付方式，请使用paymentMethodType、targetOrg进行集成，参考

【支付方式类型及目标机构说明】

【支付方式映射表-出款】

对于老版本上已经集成的支付方式，仍需使用老版本的出款字段，请继续参考以下付款申请模板：付款申请模板

三、账单变更说明

删除两个字段：Payment Method、Sub Payment Method

新增三个字段，展示形式：

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

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

删除字段与新增字段映射关系表，请参见（仅展示有变更部分）:

收款：【新老映射-收款】 出款：【新老映射-出款】

账单表头变更前后示例请参见： 【收款交易账单】、 【出款交易账单】、【资金账单】、【结算明细单】、 【结算汇总单】