Singularity Payments

A comprehensive, developer-friendly M-Pesa SDK that makes mobile payments integration effortless.

Singularity Payments is a modern TypeScript/JavaScript SDK built on top of Safaricom's Daraja API that simplifies M-Pesa integration for developers. Whether you're building an e-commerce platform, a SaaS application, or any service that requires mobile payments in Kenya, this SDK provides everything you need.

Why Singularity Payments?

While the Daraja API is powerful, integrating it directly comes with several challenges:

Type Safety First

Built with TypeScript from the ground up, you get full IntelliSense support and catch errors before they reach production. No more guessing API parameters or dealing with cryptic runtime errors.

//  Type-safe - your IDE will guide you
const result = await client.stkPush({
  amount: 1000,
  phoneNumber: "254712345678",
  accountReference: "ORDER-123",
  transactionDesc: "Payment for order",
});

//  TypeScript catches mistakes instantly
const result = await client.stkPush({
  amount: "1000", // Error: amount must be a number
  phone: "254712345678", // Error: unknown property 'phone'
});

Simplified Authentication

No need to manually handle OAuth tokens, token refresh, or authentication flows. The SDK manages all of this automatically.

// With Singularity Payments - authentication handled automatically
const client = new MpesaClient({
  consumerKey: process.env.MPESA_KEY,
  consumerSecret: process.env.MPESA_SECRET,
});

await client.stkPush({
  /* ... */
}); // Just works!

// Without SDK - manual token management required
const token = await getOAuthToken();
const headers = { Authorization: `Bearer ${token}` };
// Handle token expiry, refresh logic, etc.

Intuitive API Design

Clean, modern API that follows JavaScript/TypeScript conventions. No need to study complex Daraja documentation for hours.

STK Push

Trigger payment prompts on customer phones

Query Status

Check transaction status in real-time

Built-in Error Handling

Comprehensive error handling with descriptive messages. Know exactly what went wrong and how to fix it.

Framework Agnostic

Works seamlessly with any JavaScript framework or runtime:

Next.js
React

Industry Standard: Built following best practices from the Daraja API documentation with additional safeguards and optimizations.

Comparison

Feature	Singularity Payments	Raw Daraja API
TypeScript Support	✅ Full type safety	❌ Manual typing
Auto Authentication	✅ Handled automatically	❌ Manual token management
Error Handling	✅ Descriptive errors	❌ Raw API errors
Documentation	✅ Comprehensive	⚠️ Basic
Framework Support	✅ All frameworks	✅ All frameworks

What You Can Build

With Singularity Payments, you can implement:

E-commerce Checkouts - Accept payments for online stores
SaaS Subscriptions - Process recurring subscription payments
Ticket Sales - Sell event tickets and generate payment confirmations
Point of Sale - Build POS systems for retail
Peer-to-Peer Transfers - Enable money transfers between users
In-App Purchases - Monetize mobile applications
Bill Payments - Process utility and service bill payments
Payroll Systems - Automate salary disbursements

Getting Started

Ready to integrate M-Pesa payments? Get started in just 5 minutes:

Installation

Install the SDK and get your credentials

Quick Start

Make your first payment in minutes

Prerequisites

Before you begin, you'll need: - A Safaricom Daraja account - Your Consumer Key and Consumer Secret - A registered M-Pesa shortcode (or use sandbox for testing)

Community & Support

Ready to start? Head over to the Installation Guide to set up Singularity Payments in your project.

Introduction