Skip to main content
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.
​
package_id
string
required
Package ID
​
payment_method
string
required
Payment method (e.g., mobile_money, card)
​
provider
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"
  }
}