Skip to content

业务背景:

当前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传参变更

线上已经集成无任何影响,不需要做任何改动,系统会自动匹配传参生成订单和账单;新增支付方式接入时需要按照最新文档进行集成,详见【收银台支付-接口集成】

变更内容:

  • 接口参数中,将入参字段paymentMethod修改为paymentMethodType,取值逻辑不变

影响说明:

  • 线上已经集成的支付方式无影响,不需要重新集成
  • 新接入支付方式,请使用paymentMethodType进行集成

2.【纯API支付】

详见【纯API支付-接口集成】

变更内容:

  • Direct API将入参参数paymentMethod修改为paymentMethodType,取值逻辑不变

影响说明:

  • 线上已经集成的支付方式无影响,不需要重新集成
  • 新接入支付方式,请使用paymentMethodType进行集成

3.【回调通知】

详见【异步通知】

变更内容:

  • 新增通知参数paymentMethodType,保留参数paymentMethod,两者取值逻辑相同

影响说明:

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

4.【交易查询】

详见【交易查询】

变更内容:

  • 查询响应参数中使用paymentMethodType替换paymentMethod,两者取值逻辑相同

影响说明:

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

【出款服务】

详见【API付款】

变更内容:

  • 接口参数中,将入参字段paymentMethod修改为paymentMethodType,取值逻辑不变

影响说明:

  • 线上已集成的支付方式无影响,不需要重新集成
  • 新接入支付方式,请使用paymentMethodType

三、账单变更说明

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

新增三个字段,展示形式:

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

删除字段与新增字段映射关系表,请参见(仅展示有变更部分):【支付方式命名新老映射表】

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

Released under the MIT License.