Skip to main content

​
PalPluss Developer API

PalPluss provides a simple REST API for integrating M-Pesa payment flows into your application. Collect payments via STK Push, send payouts to mobile numbers, and manage service wallet balances — all through a single, consistent API.

​
What you can build

Collect payments

Trigger M-Pesa STK Push prompts and receive real-time results via webhooks.

Send payouts

Disburse funds directly to customer M-Pesa numbers with B2C payouts.

Manage channels

Route transactions through specific Paybill or Till shortcodes.

Monitor transactions

Query transaction status and history with a consistent pagination API.

​
API basics

DetailValue
Base URLhttps://api.palpluss.com/v1
ProtocolHTTPS only
FormatJSON
AuthenticationHTTP Basic (API key)
Rate limit60 requests/minute per API key

​
Response format

Every API response is wrapped in a standard envelope: 
{
  "success": true,
  "data": { ... },
  "requestId": "c1b2a3d4-e5f6-7890-abcd-ef1234567890"
}
Errors follow the same envelope: 
{
  "success": false,
  "error": {
    "message": "Invalid API key",
    "code": "INVALID_API_KEY",
    "details": {}
  },
  "requestId": "c1b2a3d4-e5f6-7890-abcd-ef1234567890"
}
Always save the requestId from error responses — it’s required when contacting support.

​
Next steps

Quickstart

Make your first STK Push in under 5 minutes.

Authentication

Learn how to authenticate API requests with your API key.