JoinGrove

Mobile Money Integration

Source: docs/integrations/mobile-money.md
Generated: 01/09/2026

Integrate M-Pesa, MTN MoMo, Paystack, and Paga with JoinGrove stack templates and billing stubs.

Key Concepts

  • What: Mobile money support spans the mobile-money stack template (webhooks, checkout) and billing server stubs for PPP Team tiers.
  • Why: African and emerging-market apps need local payment rails — not Stripe-only defaults.
  • Related: Stack template README, billing (billing.md), Global South hub (joingrove.globalSouthHub).

API / Reference

Provider Regions Stack template
M-Pesa Kenya, Tanzania resources/stack-templates/mobile-money/
MTN MoMo West/Central Africa Same template
Paystack Nigeria, Ghana, SA Same template
Paga Nigeria Same template

Commands

Command ID
Create stack project joingrove.createStackProject → mobile money
Show payment providers joingrove.showPaymentProviders
Subscribe Team (PPP) joingrove.subscribeTeamTier
Open tutorial joingrove.openTutorial → mobile-money-apis

Setup & Installation

  1. Command Palette → Create Global South Stack Project… → Mobile Money template.
  2. Review resources/stack-templates/mobile-money/README.md in the scaffolded project.
  3. Configure webhook URLs and API keys in your .env (never commit secrets).
  4. For PPP billing → start npm run billing-server and use Subscribe to JoinGrove Team (PPP).

Code Examples

Start billing stub for checkout testing:

npm run billing-server

Open the mobile money tutorial in-app:

Command Palette → joingrove.openTutorials → Mobile Money API Integration

Scaffold from Studio prompt:

"SokoMart shop with Paystack and GHS pricing"

Next: Use joingrove.studioBuildFromPrompt to generate a cloud project with payment stubs.

How It Connects