SWIFT-WALLET API Documentation
Enterprise-grade M-Pesa integration with advanced routing, multi-channel support, and real-time callbacks.
Key Features
Multi-Channel Routing
Paybill, Till Numbers & Bank Settlements with automatic routing based on your configuration.
Service Fee Management
Automatic fee calculation and deduction from your service wallet balance.
Real-time Callbacks
Instant payment status updates with callback data for seamless integration.
Enterprise Security
API key authentication with validation and comprehensive audit logging.
API Overview
Wallet API
Balance queries & deposits
Query service and payment wallet balances, initiate customer deposits via M-Pesa STK Push.
- Get wallet balances
- Initiate deposits
- Check deposit status
Fees API
Pricing & fee structure
Retrieve current service fees and withdrawal charges with transparent pricing structure.
- Get fee structure
- Calculate fees
- Pricing transparency
Channels API
Payment channel management
Manage payment channels: Paybill, Till Numbers, Bank Settlement, and Wallet channels with full CRUD operations.
- List channels
- Create & update
- Activate/deactivate
STK Push API
Payment initiation
Initiate M-Pesa STK Push requests to charge customers with advanced routing and callbacks.
- STK Push initiation
- Multi-channel routing
- Real-time callbacks
Transactions API
Status & history
Check transaction status by identifiers and query transaction history with rich filtering options.
- Status checking
- Transaction history
- Advanced filtering
Pay-Request (B2C)
Money transfers
Send money to customer phone numbers using Safaricom M-Pesa B2C with automatic fee handling.
- B2C payments
- Automatic fees
- Real-time callbacks
Base URLs
Production
https://swiftwallet.co.ke/v3/
Use this for all production API requests.
API Endpoints
Authentication
All API requests require authentication using your unique API key. You can obtain your API key from the SWIFT-WALLET dashboard under the "API Keys" section.
Authorization Header (Recommended)
Authorization: Bearer YOUR_API_KEY
Query Parameter
?api_key=YOUR_API_KEY
JSON Body
{
"api_key": "YOUR_API_KEY"
}
Ready to Get Started?
Make your first API request and start building with SWIFT-WALLET
# Check your wallet balances
curl -X GET "https://swiftwallet.co.ke/v3/wallet/" \
-H "Authorization: Bearer YOUR_API_KEY"