TIPS API Integration Guide v1.4 解读

文档概览

• 原始文件：TIPS API Integration Guide_version_1.4_21June2024.pdf
• 机构：Bank of Tanzania
• 文档：The Tanzania Instant Payments System API Integration Guide
• 版本：1.4，2024-06-21
• 主题：TIPS 实时支付系统 API 接入。

这份文档是坦桑尼亚实时支付系统 TIPS 的 API 集成指南。TIPS 是由 Bank of Tanzania 运营的互操作数字支付平台，连接银行和非银行金融服务商，用于实时转账、收付款、商户支付、政府支付、国际汇款等场景。

主要内容

文档覆盖 TIPS 的核心服务：

服务	说明
Account Lookup Service	付款前查询收款方账户名称和账户类型
Transfer Service	发起实时资金转账或支付
Transfer Reversal Service	发起转账撤销或冲正
Request to Pay Service	发起请求付款
Settlement Service	结算通知和对账文件
Fraud Service	中央欺诈登记、更新、查询
Communication Messaging Service	支付相关通信消息

关键 API

接口	作用
GET /parties/{identifierType}/{identifier}/sync	收款方名称查询
POST /participants/{identifierType}/sync	目录注册
PUT /participants/{identifierType}/{identifier}/sync	目录更新
GET /participants/{identifierType}/sync	目录查询
POST /transfers	发起转账
PUT /transfers/{payerRef}	转账确认或通知
GET /transfers/{payerRef}	转账查询
POST /messageTransfersReversal	发起撤销消息
POST /transfersReversal	发起转账冲正
POST /messageRequestPay	请求付款
POST /settlements	结算通知
POST /fraud	欺诈登记
PUT /fraud/{id}	欺诈信息更新
GET /fraud	欺诈信息查询
POST /message	通信消息

对传音银行的能力价值

能力分类	判断
KYC	不提供
AML	不直接提供
征信	不提供
风控	部分相关，提供 Fraud Service 作为支付反欺诈共享能力
支付	强相关
清结算	强相关
对账	强相关

这份文档主要解决传音银行的 实时跨机构支付、账户名查询、转账、冲正、请求付款、结算通知、对账和支付欺诈登记能力。

与银行业务的关系

TIPS 是传音银行在坦桑尼亚开展支付业务的重要基础设施：

• 用户向其他银行或钱包转账。
• 用户向商户付款。
• 用户向政府或机构缴费。
• 用户接收外部机构转入资金。
• 银行做跨机构支付对账和结算。
• 支付欺诈信息进入中央 Fraud Register。

它不是普通第三方支付网关，而是国家级实时支付网络。

建议接入位置

在当前四层架构中，建议归入：

• 第二层：金融业务域 / 交易模块 / 清结算模块
• 第三层：支付渠道整合系统
• 第四层：Bank of Tanzania TIPS

Fraud Service 可以同时向第二层风控域提供支付风险输入，但它不等同于贷前风控系统。

后续待确认

• 传音银行是 TIPS 直接参与方还是间接参与方。
• identifierType 中 WALLET、CONTROLNO、账户号、手机号等标识如何映射。
• Transfer 的两阶段处理、状态机、失败补偿和冲正规则。
• Settlement notification 与 reconciliation files 如何落地到银行对账系统。
• Fraud Service 是否必须接入，以及与内部反欺诈系统如何同步。