SYSNAV M-Pesa Payment Gateway

Powerful, Secure & Scalable Payment Solution

Getting Started

📝

Register

Create your API account and get instant access to the payment gateway

🔑

Configure

Add your M-Pesa credentials and webhook endpoints

💳

Integrate

Start accepting payments in minutes

Platform Integration Guides

Choose your platform and follow the complete guide

#️⃣

.NET/C#

.NET 6.0+ with HttpClient

View Guide →
⚙️

C++

C++ with libcurl & JSON libraries

View Guide →
🐍

Python

Python 3.8+ with Requests/FastAPI

View Guide →

Key Features

👥

Multi-Tenant

Isolated client data with per-client credentials

🔐

Secure Storage

Encrypted Daraja credentials in database

⚡

Real-time Updates

Webhook-based transaction status updates

📊

Complete Tracking

Full transaction lifecycle management

🛡️

Error Handling

Comprehensive error responses & logging

✅

Production Ready

Battle-tested payment processing

Payment Flow

1
Register Client
Create your application account
POST /api/v1/clients
2
Store Credentials
Save M-Pesa Daraja credentials
POST /api/v1/clients/{id}/credentials
3
Initiate Payment
Call STK Push API
POST /api/v1/stk-push
4
Customer Enters PIN
M-Pesa prompt on phone
M-Pesa USSD
5
Receive Callback
Webhook notification
POST /webhooks/mpesa
6
Check Status
Query transaction status
GET /api/v1/transactions/{id}

API Endpoints

📖 View Full API Reference

Public Endpoints

REG
/api/v1/clients
WEB
/api/v1/webhooks/mpesa
HEA
/api/v1/health
C2B
/api/v1/c2b-validation
C2B
/api/v1/c2b-confirmation

Protected Endpoints (API Key Required)

GET
/api/v1/clients
STO
/api/v1/clients/{clientId}/credentials
STK
/api/v1/stk-push
C2B
/api/v1/c2b-register
C2B
/api/v1/c2b-simulate
LIS
/api/v1/transactions
GET
/api/v1/transactions/{transactionId}

Error Codes

Code Message Action
200 Success Transaction processed
201 Created Resource created
400 Bad Request Check request parameters
401 Unauthorized Invalid/missing credentials
403 Forbidden Access denied
404 Not Found Resource not found
500 Server Error Contact support

Ready to Get Started?

Choose your platform and follow the integration guide

View Integration Guides