Skip to content

M-Pesa(Safaricom) ​

厂商定位 ​

M-Pesa 是肯尼亚 Safaricom 旗下移动支付平台,开发者能力通过 Daraja 门户(developer.safaricom.co.ke)开放。当前知识库维护两大能力面:

  1. KYC 类:Mobile Number Validation(手机号 + 证件三要素核验)、SWAP 换卡查询、Age on Network 在网时长。
  2. 支付类:B2C 出款(放款 / 提现)、STK Push 收款、C2B Paybill 入金、冲正、查单、Pochi 转账、B2C Hakikisha 收款人核身。

MINT 平台中支付类由 dpis-gw 封装,号码安全类由 drcs-gw 封装,均已进入沙箱联调阶段。

能力归属 ​

已整理资料 ​

核心能力 ​

能力接口说明
手机号三要素核验POST /v1/KYC-validation/validateID手机号 + 证件在 Safaricom 库中是否匹配,仅返回 true/false
B2C 出款 / 放款 / 提现WeRPC 02100005 → /mpesa/b2c/v3/paymentrequestACCEPTED 不入账,终态看回调
B2C Pochi 转账WeRPC service-ids.b2-pochi-transfer向 Pochi la Biashara 小微商户钱包付款
STK Push 收款WeRPC service-ids.stk-push → /mpesa/stkpush/v1/processrequest客户手机弹 PIN 框完成扣款
C2B 入金(Paybill)回调 /c2b/validation + /c2b/confirmation被动收款,Validation 模式锁 REJECT_ALL
冲正WeRPC service-ids.reversal-request30 天窗口,需审批单号留痕
双通道查单渠道 transaction-status-query / 本地 02300009TransactionID 查渠道;本地流水不调 Safaricom
SWAP 换卡查询/imsi/v2/checkATI账号接管 / 盗贷防控(仅最近 3 个月窗口)
Age on Network/registration/lookup/v1/checkATI在网时长,授信 / 反欺诈因子
B2C Hakikisha/mpesa/b2c/hakikisha/v1/hakikisha出款前收款人脱敏姓名核验,防错付

关键特性 ​

  • 手机号 / MSISDN 统一 254xxxxxxxxx(12 位),不支持 +254 / 07xx。
  • 幂等键 bizSeqNo 全局防重;状态机 ACCEPTED → SUCCESS/FAILED/UNKNOWN,超时只查单不重发。
  • Bouquet 费率模型:谁出费由 shortcode 签约决定,API 无 fee 字段;2026-08 商业费率最高降 50%。
  • 号码安全三件套均为商业按次计费,重试必须同 bizSeqNo 防费用膨胀。
  • KYC 三要素仅限 Safaricom 号码;非 Safaricom 号码需其他方案兜底。

与其他支付供应商的边界 ​

维度M-Pesa(Daraja 直连)ClickPesa(备选)Selcom(坦桑首选)
市场肯尼亚东非多国坦桑尼亚
模式运营商直连,Bouquet 计费聚合网关,API 可选费用归属聚合 + 线下代理
独有能力STK Push、Pochi、冲正、SWAP/AON/HakikishaBillPayWakala/Huduma 现金网络

接入待确认 ​

  • 银行侧正式 WeRPC serviceId 分配(含号码安全三件套)。
  • Safaricom 产品开通、ShortCode 绑定、生产回调源 IP / 专线 / 限流。
  • C2B / B2C 接入核心记账与日终对账闭环(当前仅更新渠道流水)。
  • AON 占位值 01-01-1900 口径与生产地址确认(apisupport@safaricom.co.ke)。
  • Paybill 费率官方验证(以合同附件为准)。