非洲第三方知识库

Appearance

ClickPesa 供应商分析 ​

1. 供应商定位 ​

ClickPesa 是坦桑尼亚本地的支付系统服务商，官方定位更偏：

  • 支付网关 / Payment Gateway
  • 收款与出款聚合服务
  • 移动钱包、银行卡、银行账户互联通道
  • BillPay / Checkout / Payout / Transaction Data 服务提供方

从官网与官方开发者文档看，ClickPesa 的核心不是 KYC，而是：

  • 聚合多种本地支付方式
  • 提供统一的收款入口
  • 提供单笔与批量出款能力
  • 提供商户后台与 API 接入
  • 提供交易状态与数据对账能力

官网与文档：

一句话理解：

ClickPesa 更像坦桑支付通道聚合层，统一连接移动钱包、银行卡、银行账户和 BillPay 能力。

2. 官方公开的核心能力 ​

根据官网 Payment Gateway 页，ClickPesa 当前主打两大能力：

2.1 Payments Collection ​

官方说明可用于收款，支持：

  • 借记卡和信用卡支付
  • 移动钱包支付
  • USSD PUSH 和 USSD shortcode
  • 即时银行转账
  • 自助发起清算

对应官网：

2.2 Payouts / Disbursement ​

官方说明可用于出款，支持：

  • 向银行账户出款
  • 向移动钱包出款
  • 单笔出款
  • 批量出款
  • 支持即时或当日送达
  • 支持部分政府支付（GEPG）

对应官网：

3. 支付与出款渠道覆盖 ​

官网明确提到当前覆盖的主要支付与出款渠道包括：

3.1 移动钱包 ​

  • Airtel Money
  • HaloPesa
  • M-Pesa
  • Mixx by Yas (Tigo Pesa)
  • EzyPesa

对应页面：

3.2 卡支付 ​

官网提到支持：

  • Mastercard
  • Visa
  • UnionPay

3.3 银行渠道 ​

官网 Collection 和 Disbursement 页都明确写到支持：

  • CRDB
  • NBC
  • NMB
  • And all other banks in Tanzania

对应页面：

3.4 BillPay / Control Number 场景 ​

开发者文档首页明确提到：

  • ClickPesa BillPay

其说明为：

  • 通过唯一控制号收款
  • 支持 Mobile Money
  • 支持 Simbanking
  • 支持 Wakala

对应文档：

4. 官方定价与通道费用 ​

官方定价页：

4.1 收款手续费 ​

移动钱包 Bill Pay ​

官方说明：

  • 适用于 M-Pesa、Airtel Money、Mixx by Yas、HaloPesa
  • 费用由机构承担
  • 费率为 1%
  • 金额范围：500 - 5,000,000 TZS

CRDB BillPay ​

官方说明：

  • 适用于 CRDB Sim Banking / Internet Banking / Wakala / Branch
  • 费用由机构承担
  • 费率为 1%
  • 金额范围：1,000 - 100,000,000 TZS

移动钱包 USSD PUSH ​

官方说明：

  • 适用于 M-Pesa、Airtel Money、Mixx by Yas、HaloPesa
  • 费用由付款客户承担
  • 且该费用是在运营商费用之外额外收取

它不是百分比，而是按金额区间收固定费，例如：

  • 500 - 999 TZS -> 54 TZS
  • 1,000 - 1,999 TZS -> 92 TZS
  • 10,000 - 19,999 TZS -> 920 TZS
  • 100,000 - 199,999 TZS -> 3,240 TZS
  • 2,000,000 - 3,000,000 TZS -> 7,960 TZS

这意味着：

  • Bill Pay 更像机构承担费率
  • USSD PUSH 更像客户承担按区间计费

卡支付 ​

官方说明：

  • 支持 Mastercard / Visa / UnionPay
  • 向客户收费
  • 费率为 4.85%

4.2 出款手续费 ​

移动钱包出款 ​

官方说明：

  • 可向 M-Pesa、Airtel Money、Mixx by Yas 出款
  • 手续费可由机构额外承担，也可从出款金额中扣除

也是按金额区间收费，例如：

  • 100 - 999 TZS -> 52 TZS
  • 1,000 - 1,999 TZS -> 72 TZS
  • 10,000 - 14,999 TZS -> 642 TZS
  • 100,000 - 199,999 TZS -> 1,868 TZS
  • 1,000,001 - 3,000,000 TZS -> 9,346 TZS
  • 3,000,001 - 5,000,000 TZS -> 9,890 TZS

银行 EFT / ACH 出款 ​

官方说明：

  • 适用于坦桑任意银行
  • 手续费可由机构承担，也可内嵌到出款金额中
  • 费用：2,360 TZS
  • 金额范围：0 - 20,000,000 TZS

银行 TISS 出款（TZS） ​

官方说明：

  • 适用于坦桑任意银行
  • 手续费：11,800 TZS
  • 金额范围：0 - 1,000,000,000 TZS

银行 TISS 出款（USD） ​

官方说明：

  • 手续费：7.5 USD
  • 金额范围：0 - 1,000,000 USD

4.3 接入 / 开通费用 ​

官网 Solutions Fee 明确列出：

  • Account Creation (100,000 TZS Total Transaction Limit)：Free
  • KYC Search and Onboarding (No Transaction Limit)：25,000 TZS
  • M-Pesa Channel Setup and Activation：250,000 TZS
  • Card Channel Setup and Activation：250,000 TZS
  • E-Invoicing：Free
  • Payment Pages：Free
  • CRM：Free
  • Bulk Payouts：Free

4.4 不同移动钱包的接入费用怎么看 ​

从官方定价页当前能直接确认的是：

  • 移动钱包收款 / 出款手续费 已统一列出
  • 单独的通道开通费 当前只明确列出了：
    • M-Pesa Channel Setup and Activation

官方没有在同一页明确列出：

  • Airtel Money 单独开通费
  • Mixx by Yas 单独开通费
  • HaloPesa 单独开通费

因此目前更稳妥的理解是：

  • 公开定价中，明确单列的移动钱包通道开通费只有 M-Pesa
  • 其他钱包是否单独收取接入费，官网当前没有明确写出，正式接入前应进一步确认

5. 典型业务场景 ​

5.1 在线收款 ​

适合：

  • App 内支付
  • 网站支付
  • 软件产品中的内嵌支付
  • 电商、票务、会员、服务支付

官网提到的支付工具包括：

  • Checkout Link
  • Payment Pages
  • E-Invoice

其中 Checkout Link 支持从业务系统发起 API 请求，生成可重复使用的支付链接。
对应页面：

5.2 离线 / 弱网收款 ​

适合：

  • 网络不稳定场景
  • 用户不方便在线完成支付场景

官网提到：

  • Bill Pay Reference Payment

其本质是给客户一个支付参考号，用于离线或传统渠道付款。
对应页面：

5.3 单笔与批量出款 ​

适合：

  • 供应商付款
  • 员工发薪
  • 合作方结算
  • 钱包 / 银行账户打款

官网说明：

  • 支持 Single Payout
  • 支持 Bulk Payout
  • 支持上传 Excel / CSV
  • 可追踪成功和失败的出款记录

对应页面：

5.4 BillPay / Control Number ​

适合：

  • 账单缴费
  • 客户充值
  • 贷款还款
  • 控制号 / 参考号类付款

开发者文档明确把它作为正式产品能力开放。

6. 官方接入方式 ​

从官网和开发者文档可确认，ClickPesa 至少提供以下接入方式：

6.1 Merchant Dashboard ​

官网明确提供：

  • 商户后台
  • 创建收款链接
  • 创建付款页
  • 创建发票
  • 创建支付参考号
  • 单笔 / 批量出款
  • 导出交易数据

对应页面：

6.2 API Integration ​

官网明确写到 API 可以集成：

  • Collection
  • Disbursement
  • Transaction Data

对应页面：

6.3 Hosted / Embedded / No-Code ​

开发者文档首页说明可选模式包括：

  • Hosted
  • Embedded
  • No Code
  • Single API

对应文档：

7. 官方开发者文档中可确认的产品入口 ​

从文档首页可以明确看到这些产品入口：

  • ClickPesa Checkout
  • ClickPesa BillPay
  • Payment API
  • Payout API
  • Plugins and SDK
  • API Explorer
  • Webhooks
  • Whitelist IP
  • Checksum
  • API Integration Setup

说明它的开发者文档是成体系的，不只是简单的接口说明，而是包含：

  • 接入配置
  • Webhook
  • 安全配置
  • API Explorer
  • 支付与出款状态说明

对应文档首页：

8. 已能确认的对接特征 ​

8.1 统一 API 模式 ​

文档首页写到：

  • Power every payment flow with a single API

说明它试图把收款与出款能力统一到较少的接口模型中。

8.2 支持 Webhooks ​

文档导航里公开列出：

  • Webhooks

说明其平台支持异步回调机制。

8.3 支持安全接入配置 ​

文档导航里公开列出：

  • Whitelist IP
  • Checksum

说明它在接入时至少考虑了：

  • 来源 IP 白名单
  • 请求签名 / 校验

8.4 支持交易状态与对账 ​

官网写到：

  • Transaction Data
  • 可导出 CSV / Excel
  • 支持交易跟踪

这说明它不仅提供支付执行，还提供：

  • 交易状态查询
  • 交易数据导出
  • 对账辅助能力

9. 官方文档里能确认的关键接口与参数 ​

官方 API 参考：

9.1 认证接口 ​

Generate Authorization Token ​

官方接口：

  • POST https://api.clickpesa.com/third-parties/generate-token

请求头：

  • client-id
  • api-key

返回：

  • success
  • token

说明：

  • 返回的是短时有效 JWT Token
  • 文档写明有效期为 1 hour

9.2 移动钱包收款接口 ​

Preview USSD-PUSH request ​

官方接口：

  • POST /third-parties/payments/preview-ussd-push-request

主要请求参数：

  • amount
  • currency
  • orderReference
  • phoneNumber
  • fetchSenderDetails
  • checksum

主要返回字段：

  • activeMethods
    • name
    • status
    • fee
    • message
  • sender
    • accountName
    • accountNumber
    • accountProvider

这一步的意义是：

  • 先校验手机号、金额、订单号是否可用
  • 返回当前可用的钱包通道和对应手续费

Initiate USSD-PUSH request ​

官方接口：

  • POST /third-parties/payments/initiate-ussd-push-request

主要请求参数：

  • amount
  • currency
  • orderReference
  • phoneNumber
  • checksum

主要返回字段：

  • id
  • status
  • channel
  • orderReference
  • collectedAmount
  • collectedCurrency
  • createdAt
  • clientId

说明：

  • 此接口会向用户手机发起 USSD-PUSH
  • 用户在手机侧完成 PIN / 密码确认

Query Payment Status ​

官方文档提供：

  • GET Query Payment Status

说明：

  • 用于按 Order Reference 查询支付状态
  • 适合异步收款状态追踪

9.3 移动钱包出款接口 ​

Preview Mobile Money Payout ​

官方接口：

  • POST /third-parties/disbursement/mno-payout/preview-mno-payout

主要请求参数：

  • amount
  • phoneNumber
  • currency
  • orderReference
  • checksum

主要返回字段：

  • amount
  • balance
  • channelProvider
  • fee
  • exchanged

作用：

  • 校验钱包出款是否可执行
  • 预估实际扣款金额
  • 返回通道和费用

Create Mobile Money Payout ​

官方接口：

  • POST /third-parties/disbursement/mno-payout/create-mno-payout

主要请求参数：

  • amount
  • phoneNumber
  • currency
  • orderReference
  • checksum

主要返回字段：

  • id
  • orderReference
  • amount
  • currency
  • fee
  • exchanged
  • exchange
  • status
  • channel

9.4 银行出款接口 ​

Retrieve Account Balance ​

官方接口：

  • GET Retrieve Account Balance

作用：

  • 用于在出款前先检查商户账户余额是否充足

Retrieve Banks List ​

官方接口：

  • GET Retrieve Banks List

作用：

  • 获取银行清单
  • 获取可用于出款的 BIC

Preview Bank Payout ​

官方接口：

  • POST /third-parties/disbursement/bank-payout/preview-bank-payout

主要请求参数：

  • amount
  • accountNumber
  • currency
  • orderReference
  • bic
  • transferType
    • ACH
    • RTGS
  • accountCurrency
  • checksum

主要返回字段：

  • amount
  • balance
  • channelProvider
  • fee
  • exchanged

Create Bank Payout ​

官方接口：

  • POST /third-parties/disbursement/bank-payout/create-bank-payout

主要请求参数：

  • amount
  • accountNumber
  • accountName
  • currency
  • orderReference
  • bic
  • transferType
  • accountCurrency
  • checksum

主要返回字段：

  • updatedAt
  • createdAt
  • id
  • orderReference
  • amount
  • currency
  • fee
  • exchanged

9.5 BillPay 接口 ​

官方 API 参考中还能确认其提供：

  • POST Create Order Control Number
  • POST Create Customer Control Number
  • GET Query BillPay Number Details
  • PATCH Update BillPay Reference
  • PUT Update BillPay Number Status

这说明其 BillPay / Control Number 是正式 API 能力，而不是只有后台手工能力。

10. 平台账户模型特征 ​

官网中有几个明显信号：

  • Single account for all payments
  • Merchants no longer have to open multiple accounts
  • Deposit for payouts from any bank and mobile money account

这说明它的产品模型更像：

  • 商户在 ClickPesa 上有统一账户 / 商户平台入口
  • 从这个统一账户管理多种支付方式
  • 收款和出款能力由平台统一协调

这类模型通常意味着实际接入时要重点确认：

  • 资金沉淀与结算逻辑
  • 清算到银行账户还是平台钱包
  • 对账与账务归属方式

官网当前没有把这部分写得非常细，所以若后续对接，建议单独确认。

11. 官方资质与合规信息 ​

官网页脚明确写到：

DLT CP TANZANIA COMPANY LIMITED trading as CLICKPESA TANZANIA is licensed by Bank of Tanzania (BoT) under the Payments System Licensing and Approval Regulations 2015, License No: NBPSL No. 0000-31

可理解为：

  • ClickPesa Tanzania 是坦桑本地持牌支付系统服务机构
  • 受坦桑尼亚央行（BoT）监管

对应来源：

12. 后续对接时建议重点确认的内容 ​

虽然官网和开发者文档已经比较完整，但如果后续要做正式接入，仍建议重点确认这些事项：

12.1 认证方式 ​

开发者文档首页能确认有：

  • API Integration Setup
  • Whitelist IP
  • Checksum

但具体请求头、签名算法、Token 生命周期等，仍建议在正式接入时进一步核实。

12.2 回调模型 ​

既然文档有 Webhooks，建议重点确认：

  • 回调触发时机
  • 回调重试机制
  • 幂等键
  • 签名校验规则

12.3 状态流转 ​

文档首页能看到：

  • Payment Statuses
  • Payout Statuses

建议正式接入前明确：

  • 收款成功 / 失败 / 处理中状态
  • 出款成功 / 失败 / 处理中状态
  • 是否存在中间态与人工处理态

12.4 渠道成熟度 ​

官网虽然列出了很多渠道，但仍建议重点确认：

  • 各钱包通道的正式上线状态
  • 各银行通道的实时性差异
  • 银行侧名校验能力是否全量可用
  • GEPG 是否已正式对外开放

12.5 费用模型 ​

官网有定价页，但不同产品、不同通道、不同结算方式的费用结构，建议单独确认：

  • 向商户收费
  • 向付款人收费
  • 最低金额限制
  • 通道附加费

13. 官网已确认 / 需进一步商务确认 ​

13.1 已由官网确认 ​

以下内容已能通过 ClickPesa 官网或官方开发者文档直接确认：

  • ClickPesa 是坦桑本地持牌支付系统服务商
  • 提供 Collection 与 Disbursement 两大核心能力
  • 支持移动钱包、银行卡、银行账户等多种支付方式
  • 覆盖的钱包品牌包括：
    • M-Pesa
    • Airtel Money
    • Mixx by Yas
    • HaloPesa
    • EzyPesa
  • 官方明确提供：
    • Checkout
    • BillPay
    • Payment API
    • Payout API
    • Webhooks
    • API Explorer
    • Whitelist IP
    • Checksum
  • 官方公开了认证接口和核心支付 / 出款 API
  • 官方公开了主要手续费规则：
    • 移动钱包 BillPay 1%
    • CRDB BillPay 1%
    • USSD PUSH 按金额区间收费
    • 卡支付 4.85%
    • 移动钱包出款按金额区间收费
    • 银行 EFT / ACH 与 TISS 有固定或分档费用
  • 官方公开了部分接入费：
    • 账户创建免费
    • KYC / Onboarding 25,000 TZS
    • M-Pesa 通道开通 250,000 TZS
    • 卡通道开通 250,000 TZS
  • 官方公开了 BillPay / Control Number 类接口
  • 官方公开了银行列表、余额查询、支付状态、出款状态相关接口

13.2 需进一步商务确认 ​

以下内容官网未完全写清，正式接入前建议通过商务、技术对接或联调确认：

  • Airtel Money、Mixx by Yas、HaloPesa 是否存在单独通道开通费
  • 各移动钱包通道是否都已正式稳定上线，还是有阶段性开通差异
  • 各银行通道的实时性是否一致，哪些银行是即时、哪些走批量或清算
  • GEPG 当前是否已正式开放给新客户接入
  • 银行账户名校验、手机号姓名校验等辅助能力是否全量可用
  • 资金到底是直接进商户银行账户，还是先沉淀在平台统一账户 / 钱包中
  • 结算与提现的时效、对账方式、失败回退机制
  • Webhooks 的重试机制、幂等规则、签名算法细节
  • Checksum 的生成规则与验签要求
  • 生产环境是否需要额外白名单、专线或审批流程
  • 测试环境与正式环境的额度限制、通道限制是否一致
  • 费用承担方式是否支持灵活配置：
    • 全部由商户承担
    • 全部由付款人承担
    • 商户与客户分摊
  • 退款、冲正、失败出款重试、人工处理流程是否有正式能力支持
  • Bulk Payout 的批量限制、文件格式、幂等规则和错误回执格式

14. 一句话总结 ​

ClickPesa 是一家坦桑本地持牌支付系统服务商，官方能力主要围绕 Collection、Disbursement、Checkout、BillPay、Payout API、Webhooks 和交易数据。
从官网和官方开发者文档看，它已经具备较完整的商户后台和 API 接入体系，适合作为支付聚合与资金通道供应商进行评估和接入。