Generating Vouchers

Learn how to generate voucher codes through the Kitonga dashboard or API.

Generate via Dashboard

1. Go to Vouchers in the sidebar
2. Click the Generate button
3. Fill in the form:
   • Quantity - Number of vouchers (1-1000)
   • Duration - Access time
   • Send SMS - Optional phone number
   • Notes - Optional description
4. Click Generate Vouchers

Generate via API

POST /api/portal/vouchers/generate/
Authorization: X-API-Key YOUR_API_KEY
Content-Type: application/json

{
  "quantity": 10,
  "duration_hours": 24,
  "phone_number": "255712345678",
  "notes": "January promotion"
}

Response Example

{
  "success": true,
  "vouchers": [
    {
      "id": 1,
      "code": "A1B2-C3D4-E5F6",
      "duration_hours": 24,
      "is_used": false,
      "created_at": "2026-01-14T10:30:00Z"
    }
  ]
}