{
"package_id": "550e8400-e29b-41d4-a716-446655440000",
"payment_method": "mobile_money",
"provider": "mpesa"
}
{
"success": true,
"purchase": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"package_name": "Starter Package",
"sms_count": 1000,
"price": 50.00,
"currency": "USD",
"status": "pending",
"payment_url": "https://payment.gateway.com/pay/xyz123",
"created_at": "2025-11-27T10:30:00Z"
}
}
Billing & Payments
Purchase SMS Package
POST
/
api
/
billing
/
sms
/
purchase
/
{
"package_id": "550e8400-e29b-41d4-a716-446655440000",
"payment_method": "mobile_money",
"provider": "mpesa"
}
{
"success": true,
"purchase": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"package_name": "Starter Package",
"sms_count": 1000,
"price": 50.00,
"currency": "USD",
"status": "pending",
"payment_url": "https://payment.gateway.com/pay/xyz123",
"created_at": "2025-11-27T10:30:00Z"
}
}
Purchase an SMS package.
string
required
Package ID
string
required
Payment method (e.g., mobile_money, card)
string
Payment provider (e.g., mpesa, tigopesa)
Request Example
{
"package_id": "550e8400-e29b-41d4-a716-446655440000",
"payment_method": "mobile_money",
"provider": "mpesa"
}
Success Response (201)
{
"success": true,
"purchase": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"package_name": "Starter Package",
"sms_count": 1000,
"price": 50.00,
"currency": "USD",
"status": "pending",
"payment_url": "https://payment.gateway.com/pay/xyz123",
"created_at": "2025-11-27T10:30:00Z"
}
}