M-Pesa Wallet
Temporarily unavailable
The M-Pesa wallet is paused for now and will be back soon. Your other payment tools (M-Pesa accounts, links, cards, Airtel) are unaffected.
Receive M-Pesa to your paybill + account number. Withdraw to any M-Pesa number (5% fee; minimum 10 KES).
Paybill –
Account no. –
Deposit via STK push
Request a withdrawal
You receive 95% (5% fee). Requests are reviewed before payout; the amount is reserved from your wallet meanwhile. Requires a signed-in session (not an API key).
Identity verification …
API keys (for integrating deposits)
Use your API key to credit this wallet from your own system — send it as the
X-API-Key header on POST /api/wallet/deposit ({ phone, amount }).
…
…
Wallet account number: … — customers can also pay the paybill with this number to top you up.
curl -X POST https://www.pay.cloud.or.ke/api/wallet/deposit \
-H "X-API-Key: <LIVE_KEY>" -H "Content-Type: application/json" \
-d '{"phone":"254712345678","amount":500}'
Wallet webhook (callback URL)
Get notified when a deposit or withdrawal completes. We sign each POST with the
secret below (header X-CloudPay-Signature). See docs.