Developer Documentation

Complete API documentation for integrating PayNexus M-Pesa payments into your applications

Browse Documentation Quick Start
Documentation
API Reference
Base URL
https://paynexus.co.ke/api
Authentication
X-API-Key: your_key_here

PayNexus M-Pesa API Documentation

Complete documentation for integrating PayNexus M-Pesa payments into your applications.

Quick Start Guide

Get your M-Pesa payment integration up and running in minutes! Perfect for developers who want to start quickly.

  • 5-minute basic setup
  • Language-specific examples
  • Testing procedures
  • Production checklist
Start Now →

Integration Guide

Comprehensive guide covering API endpoints, authentication, error handling, and best practices.

⚠️ Updated: Critical account reference routing information included
  • Complete API reference
  • Authentication methods
  • Account reference routing guide
  • Error handling patterns
  • Security best practices
Read Guide →

Webhook Guide

Learn how to set up webhooks for real-time payment notifications and status updates.

  • Webhook setup and security
  • Payload structure reference
  • Language-specific handlers
  • Testing and troubleshooting
View Guide →

Code Examples

Ready-to-use code examples in PHP, JavaScript, Python, and cURL for rapid integration.

⚠️ Updated: All examples now include proper account reference handling
  • PHP (Vanilla, Laravel) with proper routing
  • JavaScript (Node.js, Express) with account type checking
  • Python (Flask, Django) with complete workflow
  • cURL scripts with automated account reference logic
View Examples →

Live API Documentation

Interactive API documentation with real-time endpoint testing and comprehensive reference.

  • Interactive testing
  • Auto-generated examples
  • Real-time validation
  • Stable API reference
Open API Docs →

Stable API Features

Production-ready API with payment initiation, status checks, merchant management, and webhook support.

  • Payment initiation and tracking
  • Merchant and API key management
  • Webhook registration
  • Consistent error handling
Learn More →

📡 Stable API

v1.0 Stable API

✅ Production Ready

The stable PayNexus API provides the core payment processing features used by merchant integrations.

Payment initiation
Payment status checking
Webhook support
Merchant management
Rate Limit 60 req/min
Base URL /api
View API Docs
1

Get API Keys

Obtain your Public and Secret keys from the PayNexus dashboard

2

Choose Language

Select your preferred programming language

3

Follow Quick Start

Complete the 5-minute integration

4

Test & Deploy

Test your integration and go live

📞 Need Help?

For technical support and questions:

support@paynexus.co.ke GitHub Repository