产品在V3.9.1基于SAAS-九牧王的需求做好了跟招行CBS-8的对接，实现的接口需求有以下3个：1、待支付指令推送接口；2、支付结果同步接口；3、银行流水同步接口。本文章将先介绍公共部分的配置，然后再按照上述3个接口分别进行介绍。详细内容如下：

公共配置部分

1、全局字典配置

菜单路径：【配置平台】-【系统管理】-【系统字典】-【全局字典】

配置如下3个全局字典：

BODY_ENCRYPTION_KEY：填写CBS加密平台公钥
SIGN_ENCRYPTION_PRIVATEKEY：填写CBS企业加密私钥
BODY_DECRYPTION_KEY：填写CBS企业解密私钥

2、外部数据编码配置

菜单路径：【配置平台】-【系统管理】-【外部数据编码】

配置财务共享系统和CBS-8的币种和银行数据的映射关系：

1）币种数据

数据类型：CURRENCY_SYS

外部系统编码：PAY-CBS8

2）银行数据

数据类型：BANK_SYS

外部系统编码：PAY-CBS8

待支付指令推送接口

1、接口功能说明

接口平台先调共享的《支付指令查询接口》获取“待付款”的支付指令，转换处理后调CBS的《支付指令接收接口》进行推送

2、接口触发说明

该接口为定时器触发

3、接口所涉配置点说明

1）接口参数配置

菜单路径：【配置平台】-【接口管理】-【系统定义】-【接口管理】

找到接口-【PUSH_PAYMENT_INSTRUCTIONS/支付指令推送CBS接口】，点击【接口参数】进去，配置以下参数：

appId：填写CBS提供的appId

appSecret：填写CBS提供的appSecret

tokenUrl：填写CBS提供的token接口地址

url：填写CBS提供的支付接口地址

2）定时器配置

菜单路径：【配置平台】-【接口管理】-【定时任务】-【定时器管理】

新增一个定时器：

平台：共享中心

Bean名称：interfaceTask

方法名：pushPaymentInstructions

方法可重复：否

定时器名称：共享查询CBS-8付款申请单终态

Cron表达式：自行配置，推荐7点到19点，每隔5分钟运行一次

4、TAPD需求链接

https://www.tapd.cn/67410840/prong/stories/view/1167410840001204490

支付结果同步接口

1、接口功能说明

支付结果的同步包括两部分：一是正常支付的结果同步，二是支付退票的结果同步。所以，实际上本接口需求的实现涉及到两个接口：

1）对于正常支付的结果，接口平台先调共享的《支付指令查询接口》获取“付款中”的支付指令，转换处理后调CBS的《支付列表查询接口》查询支付结果，转换处理后调共享的《支付结果同步接口》同步支付结果；

2）对于支付退票的结果，直接按时间区间调CBS的《支付列表查询接口》查询所有支付结果，然后只处理返参数据中payStatus为”j-退票“的，调共享的《支付结果同步接口》将支付指令的付款状态更新为”12-支付退票“。

2、接口触发说明

该接口为定时器触发

3、接口所涉配置点说明

1）接口参数配置

菜单路径：【配置平台】-【接口管理】-【系统定义】-【接口管理】

找到接口-【GET_INSTRUCTION_RESULTS/获取CBS支付结果接口】和接口-【GET_INSTRUCTION_FOR_TICKET_REFUND/获取CBS支付退票结果】，点击【接口参数】进去，配置以下参数：

appId：填写CBS提供的appId

appSecret：填写CBS提供的appSecret

tokenUrl：填写CBS提供的token接口地址

url：填写CBS提供的支付接口地址

2）定时器配置

该接口涉及到2个定时器：《共享查询CBS-8付款申请单终态》、《共享查询CBS-8支付退票数据》

菜单路径：【配置平台】-【接口管理】-【定时任务】-【定时器管理】

新增定时器-《共享查询CBS-8付款申请单终态》：

平台：共享中心

Bean名称：interfaceTask

方法名：inStructionResults

方法可重复：否

定时器名称：共享查询CBS-8付款申请单终态

Cron表达式：自行配置，推荐8点到18点，每隔30分钟运行一次

新增定时器-《共享查询CBS-8支付退票数据》：

平台：共享中心

Bean名称：interfaceTask

方法名：ticketre

方法可重复：否

定时器名称：共享查询CBS-8支付退票数据

Cron表达式：自行配置，推荐8点到18点，每隔30分钟运行一次

4、TAPD需求链接

https://www.tapd.cn/67410840/prong/stories/view/1167410840001204494

银行流水同步接口

1、接口功能说明

接口平台先调cbs的《交易明细查询接口》获取流水明细，转换处理后调共享的《流水同步接口》进行推送

2、接口触发说明

该接口为定时器触发

3、接口所涉配置点说明

1）接口参数配置

菜单路径：【配置平台】-【接口管理】-【系统定义】-【接口管理】

找到接口-【OBTAIN_DETAILED_FLOW_INFORMATION/获取CBS流水】，点击【接口参数】进去，配置以下参数：

appId：填写CBS提供的appId

appSecret：填写CBS提供的appSecret

tokenUrl：填写CBS提供的token接口地址

url：填写CBS提供的支付接口地址

2）定时器配置

该接口涉及到定时器：《CBS交易明细查询》

菜单路径：【配置平台】-【接口管理】-【定时任务】-【定时器管理】

新增定时器-《CBS交易明细查询》：

平台：认领平台

Bean名称：interfaceTask

方法名：obtainingFlowingDataCbs

方法可重复：否

定时器名称：CBS交易明细查询

Cron表达式：自行配置，推荐1点到23点，每隔30分钟拉去一次

4、TAPD需求链接

【【九牧王】认领平台接口新增：获取流水明细接口】

https://www.tapd.cn/67410840/prong/stories/view/1167410840001204627

招行CBS产品化对接内容介绍

关联知识库

招行CBS产品化对接内容介绍

关于作者

关联知识库

目录