业务背景:
当前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保持一致
删除字段与新增字段映射关系表,请参见(仅展示有变更部分):