# Dukene Full Documentation (LLM-optimized)

This file contains the exhaustive details of the Dukene platform for LLM ingestion.

## About Dukene
Dukene is the first WhatsApp-centric e-commerce solution built for Kenya. It bridges the gap between traditional social selling (WhatsApp/Instagram) and professional e-commerce management.

### Value Proposition
- **For Merchants**: Professional presence without technical complexity. M-Pesa automated.
- **For Affiliates**: Reliable commissions and products that sell themselves on social media.
- **For Suppliers**: Direct pipe to a massive network of retail merchants.

## Platform Features

### WhatsApp Integration
- QR code scanning for WhatsApp Business accounts.
- Automated order notifications via WhatsApp.
- Direct-to-chat customer support buttons.
- Catalog browsing within WhatsApp.

### Payments & M-Pesa
- Paybill and Till Number integration.
- Instant payment verification.
- Weekly/Bi-weekly/Monthly payout cycles.
- Minimum payout: KES 1,000.
- Bank transfers available for amounts > KES 50,000.

### Affiliate Network
- **Commission Control**: Commission rates are **determined solely by the sellers** for each individual product they add. Merchants have the flexibility to offer different rates for different items based on their business model and profit margins.
- **Standard Tiers (Recommended)**: 
  - Standard (Electronics/Fashion): 6-15%
  - Premium (Luxury/Services): 15-25%
  - Digital (Software/Education): 25-40%
- Real-time tracking of clicks and conversions.
- Marketing templates provided for social media.

## Step-by-Step Merchant Journey

1. **Phase 1: Onboarding** - Account creation + free custom domain.
2. **Phase 2: Supply** - Upload products or link with suppliers for auto-sync.
3. **Phase 3: Marketing** - Verified affiliates promote links on social media.
4. **Phase 4: Fulfillment** - Orders processed, fees deducted, everyone paid automatically via M-Pesa.

## Detailed FAQ (Knowledge Base)

### Getting Started
- **Account Creation**: Requires email, phone, business name. Verification link sent via email.
- **Requirement**: Dukene account, business info, products, M-Pesa account. WhatsApp Business recommended.
- **Cost**: No setup or monthly fees. Small transaction fee per sale + merchant-defined affiliate commission.

### Products & Orders
- **Bulk Import**: Support for CSV import (up to 1,000 products).
- **Inventory**: Automatic deduction on sale. Low stock alerts. Pre-order support.
- **Refunds**: Processed via dashboard. 5-7 business days. Transaction fees non-refundable.

### Troubleshooting
- **Visibility**: Ensure product is "Published", has image, price, and stock > 0.
- **Notifications**: Check Settings > Notifications and spam folder.
- **Payouts**: Delays caused by pending verification, suspicious activity, or bad payout info.

## Developer Documentation (Full Spec)

- **Base URL**: `https://api.dukene.com/api/v1`
- **Rate Limit**: 100 requests per minute.

### OAuth 2.0 Flow
1. Redirect merchant to `https://dukene.co.ke/oauth/authorize?client_id=...&scope=...&redirect_uri=...`
2. Receive code at `redirect_uri`.
3. Exchange code for token at `POST /oauth/token`.
4. Refresh token as needed.

### Webhooks
- **Header**: `X-Dukene-Signature` (HMAC-SHA256).
- **Events**:
  - `ORDER_CREATED`: Triggered on new order.
  - `ORDER_UPDATED`: Triggered on status change.
  - `PRODUCT_UPDATED`: Triggered on catalog change.
  - `INVENTORY_LOW`: Alert for suppliers to restock.
- **Security**: Suppliers MUST verify the signature against their shared secret.

## Full Page Index
- Home: `/`
- About: `/about`
- Features: `/features`
- How it Works: `/how-it-works`
- Payments: `/payments`
- Roadmap: `/roadmap`
- Getting Started: `/getting-started`
- Help Center: `/help`
- Contact: `/contact`
- Video Tutorials: `/tutorials`
- Community: `/community`
- Developer Docs: `/docs`
- Affiliate Program: `/affiliate`
- Commission Structure: `/commissions`
- Privacy: `/privacy`
- Terms: `/terms`
- Cookies: `/cookies`
- Acceptable Use: `/acceptable-use`
- Merchant Agreement: `/merchant-agreement`

## Community Hubs
- **Merchant Mastermind**: WhatsApp Group (1.2k+ members).
- **Affiliate Stars**: Discord Server (800+ members).
- **Digital Commerce Kenya**: Facebook Group (5k+ members).

## Support & Contact
- **Developer Support**: developers@dukene.co.ke
- **General Support**: support@dukene.co.ke
- **WhatsApp**: +254 700 000 000
- **Phone**: +254 700 000 000
- **Hours**: Mon-Fri 8AM-6PM, Sat 9AM-4PM (EAT).