Appearance
M-Pesa(Safaricom)
厂商定位
M-Pesa 是肯尼亚 Safaricom 旗下移动支付平台,开发者能力通过 Daraja 门户(developer.safaricom.co.ke)开放。当前知识库维护两大能力面:
- KYC 类:Mobile Number Validation(手机号 + 证件三要素核验)、SWAP 换卡查询、Age on Network 在网时长。
- 支付类:B2C 出款(放款 / 提现)、STK Push 收款、C2B Paybill 入金、冲正、查单、Pochi 转账、B2C Hakikisha 收款人核身。
MINT 平台中支付类由 dpis-gw 封装,号码安全类由 drcs-gw 封装,均已进入沙箱联调阶段。
能力归属
已整理资料
- M-Pesa 手机号验证接口整理:Mobile Number Validation 全量接入说明。
- M-Pesa 支付与号码安全接口整理:B2C / STK Push / C2B / 冲正 / 查单 + SWAP / AON / Hakikisha + Bouquet 费率模型。
核心能力
| 能力 | 接口 | 说明 |
|---|---|---|
| 手机号三要素核验 | POST /v1/KYC-validation/validateID | 手机号 + 证件在 Safaricom 库中是否匹配,仅返回 true/false |
| B2C 出款 / 放款 / 提现 | WeRPC 02100005 → /mpesa/b2c/v3/paymentrequest | ACCEPTED 不入账,终态看回调 |
| 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-request | 30 天窗口,需审批单号留痕 |
| 双通道查单 | 渠道 transaction-status-query / 本地 02300009 | TransactionID 查渠道;本地流水不调 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/Hakikisha | BillPay | Wakala/Huduma 现金网络 |
接入待确认
- 银行侧正式 WeRPC serviceId 分配(含号码安全三件套)。
- Safaricom 产品开通、ShortCode 绑定、生产回调源 IP / 专线 / 限流。
- C2B / B2C 接入核心记账与日终对账闭环(当前仅更新渠道流水)。
- AON 占位值
01-01-1900口径与生产地址确认(apisupport@safaricom.co.ke)。 - Paybill 费率官方验证(以合同附件为准)。