Episodes (1)
Season Pass
Unlock all 1 episodes + Exclusive Behind-the-Scenes content.
Make Money Sharing
Earn rewards for every episode unlock you generate via your link.
Login to get your promo linkRate this Series
Series Stats
Two-Step Authentication
We have sent you a code to your emailReport Update
User Manuals
Creator Guide 🚀
1. Getting Started
Access "Edit My Page" to setup your profile. Upload high-quality profile and header images. Don't forget to submit your ID for verification to unlock monetization!
2. Content Creation
Post photos, videos, or audio. Use Reels for short-form viral content and Stories for daily updates. Set content as "Locked" to reward your subscribers.
3. Monetization
- Set your Subscription Price and custom Membership Tiers.
- Generate QR Tips for events and live streams.
- Sell digital or physical goods in your Shop.
- Offer Private Live Streams or calls.
Pro Tip: Content Rewards
Browse active Brand Campaigns to earn by views (CPM) or actions (CPA).
Brand Guide 🏢
1. Brand Profile
Setup your official profile in "Brand Settings". Verified brands get higher trust from the top creators.
2. Launching Campaigns
Create CPM or CPA campaigns. Your budget is held in secure Escrow, ensuring you only pay for verified performance results.
3. Tracking ROI
Monitor real-time analytics for your campaigns. See exactly which creators are driving sales and scale your winning partnerships.
Success Secret
Use our Smart Matching AI to find creators that align perfectly with your brand's audience intent.
Fan Guide ❤️
1. Discover
Use the Explore tab to find creators by interest. Follow them for free or subscribe to get in the inner circle.
2. Supporting Creators
- Subscribe to unlock exclusive photos and videos.
- Tip directly on posts or via QR codes at events.
- Unlock PPV (Pay-Per-View) posts for premium experiences.
3. My Wallet
Add funds to your Sponzar wallet for instant checkouts. Track your support history in your account dashboard.
Stay Connected
Purchase tickets for upcoming live performances and meet-and-greets in the Shop!
API Developer Guide 🛠️
Authentication
All API requests require an API key passed via the X-Api-Key header.
curl -H "X-Api-Key: sk_live_your_key" \
https://sponzar.africa/api/v1/contentGet your API key from the admin panel → API Keys.
Permission Scopes
| Scope | Access |
|---|---|
content.read | List & view content, series, episodes, stream URLs |
content.write | Create posts from external sites |
payments | Subscriptions, tips, PPV purchases, payouts |
creators.read | Search and filter creators |
campaigns | Create and manage content reward campaigns |
webhooks | Register and manage webhook endpoints |
shop | List and purchase products |
tickets | List events, buy & validate tickets |
bookings | List services, create & manage bookings |
* | Full access (all scopes) |
Content Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/content | List posts (filter by type, access, creator) |
| GET | /api/v1/content/{id} | Get single post |
| POST | /api/v1/content | Create a new post |
| GET | /api/v1/content/{id}/stream | Get signed media URLs |
Series Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/series | List series (micro-dramas, TV, music, podcasts) |
| GET | /api/v1/series/{id} | Series detail with episodes |
| GET | /api/v1/series/{id}/episodes | List episodes with unlock status |
| GET | /api/v1/series/{sId}/episodes/{eId}/stream | Stream episode media |
| POST | /api/v1/series/{sId}/episodes/{eId}/purchase | Buy episode or season pass |
Monetization Endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/subscriptions | Subscribe user to creator |
| POST | /api/v1/tips | Send a tip |
| POST | /api/v1/payments | PPV purchase or wallet deposit |
| POST | /api/v1/payouts | Request creator payout |
Other Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/creators | Search creators |
| POST | /api/v1/campaigns | Create campaign |
| POST | /api/v1/campaigns/{id}/assign | Assign creators |
| GET | /api/v1/campaigns/{id}/performance | Campaign analytics |
| POST | /api/v1/webhooks | Register webhook endpoint |
Shop Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/shop/products | List products (filter by creator, category, type) |
| GET | /api/v1/shop/products/{id} | Product detail with images & tier prices |
| POST | /api/v1/shop/products/{id}/purchase | Buy a product (wallet payment) |
Ticketing Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/tickets/events | List events (ticket-type products) |
| GET | /api/v1/tickets/events/{id} | Event detail with pricing rules |
| POST | /api/v1/tickets/events/{id}/purchase | Buy ticket(s) — returns QR code |
| GET | /api/v1/tickets/mine | List user's purchased tickets |
| POST | /api/v1/tickets/{id}/validate | Validate/scan a ticket at event |
Booking Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/bookings/services | List creator booking services |
| GET | /api/v1/bookings/services/{id} | Service detail with extras & add-ons |
| POST | /api/v1/bookings | Create booking (escrow payment) |
| GET | /api/v1/bookings/mine | List user's bookings |
| POST | /api/v1/bookings/{id}/cancel | Cancel booking (escrow refund) |
EventOS Vendor Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/vendors | List verified event vendors (filter by category) |
| GET | /api/v1/vendors/{id} | Vendor profile with services & portfolio |
| GET | /api/v1/vendors/services | Catalog of bookable vendor services |
| POST | /api/v1/vendors/services/{id}/hire | Hire vendor via Sponzar Escrow |
Error Codes
| Code | Error | Meaning |
|---|---|---|
| 401 | api_key_required | No API key provided |
| 401 | invalid_api_key | Key doesn't exist |
| 402 | insufficient_balance | Wallet balance too low |
| 403 | api_key_disabled | Key deactivated |
| 403 | purchase_required | Content is locked |
| 429 | — | Rate limit exceeded |
Webhooks
Register endpoints to receive real-time notifications:
payment.completed— A payment was processedsubscription.created— A new subscription startedcontent.published— New content was postedcampaign.completed— A campaign finished
Webhooks include an X-Sponzar-Signature header (HMAC-SHA256) for verification.
Inline Purchase Flow (No Redirect!)
Purchases happen entirely on your website via API calls — users never leave your site. Here's the full flow:
Step 1: Fetch content and check lock status
GET /api/v1/content/{id}
// Response includes: "locked": "yes", "price": 25.00Step 2: Show paywall on your site if locked: "yes"
// Your frontend shows a "Buy" button with the priceStep 3: User clicks Buy → your backend calls the purchase API
POST /api/v1/payments
{ "user_id": 42, "amount": 25.00, "type": "ppv", "target_id": 99 }Step 4: On success, fetch the stream URL
GET /api/v1/content/99/stream?user_id=42
// Returns: { "video_url": "https://...", "hls_url": "https://..." }Step 5: Display the unlocked content on your site
The same flow works for episodes:
// Check episode lock status
GET /api/v1/series/42/episodes?user_id=123
// Episode shows "is_unlocked": false, "price": 15.00
// Purchase episode
POST /api/v1/series/42/episodes/99/purchase
{ "user_id": 123, "purchase_type": "episode" }
// Or buy the full season pass
POST /api/v1/series/42/episodes/99/purchase
{ "user_id": 123, "purchase_type": "series_pass" }
// Stream the unlocked episode
GET /api/v1/series/42/episodes/99/stream?user_id=123Subscriptions also work inline:
POST /api/v1/subscriptions
{ "user_id": 42, "creator_id": 7, "plan_interval": "monthly" }Rate Limiting
Each API key has a per-minute rate limit (default: 60 req/min). Exceeding it returns 429 Too Many Requests.
WordPress Plugin 🔌
Sponzar Connect for WordPress
Turn any WordPress site into a monetized creator hub. Embed content grids, video series, music albums, event tickets, tip jars, bookings, and verified suppliers with zero code.
Version 1.0.0 · Compatible with WordPress 5.6 to 6.5+ · PHP 7.4+
1. Installation & Setup
- Download
sponzar-connect.zipusing the button above. - In your WordPress Admin, navigate to Plugins → Add New → Upload Plugin.
- Upload the ZIP file, click Install Now, and then Activate.
- Go to Settings → Sponzar in your admin sidebar.
- Paste your API Key (or Embed Token) and click Test Connection to confirm.
2. Complete Shortcodes Directory
Place these shortcodes in posts, pages, or Elementor/Gutenberg blocks:
| Shortcode | Capability & Parameters |
|---|---|
[sponzar_content] | Posts feed (video, audio, photos) with locked frosted overlay & unlock CTA. Attrs: type="video", access="all", columns="3", per_page="6" |
[sponzar_series] | Series catalog (micro-dramas, TV, music, podcasts) with 2:3 posters. Attrs: type="micro_drama", columns="4", per_page="8" |
[sponzar_series_detail] | Full series hero banner, synopsis, Season Pass button, and episode player. Attrs: id="101" |
[sponzar_creators] | Creator discovery grid with avatar, bio, badge, and subscription tier rates. Attrs: category="music", columns="4" |
[sponzar_subscribe] | Tiered fan subscription membership box with 1-click recurring wallet checkout. Attrs: creator_id="12", theme="dark" |
[sponzar_tip] | Creator tip jar with preset ZAR buttons (R20, R50, R100), custom amount & message. Attrs: creator_id="12", theme="dark" |
[sponzar_events] | Live events listing with date badges, venue location, capacity, & ticket tiers. Attrs: columns="3", per_page="6" |
[sponzar_tickets] | Direct event ticket purchasing box with instant QR code delivery to attendee wallet. Attrs: event_id="7" |
[sponzar_shop] | Creator digital product storefront (downloads, sample packs, presets, merch). Attrs: columns="4", per_page="8" |
[sponzar_booking] | Bookable 1-on-1 creator appointments (coaching, mentorship, studio sessions). Attrs: creator_id="12" |
[sponzar_vendors] | EventOS verified supplier marketplace (Sound, Stage, Catering) with Escrow hire. Attrs: category="Sound & Audio", columns="3" |
[sponzar_embed] | Universal SDK loader rendering any Sponzar Web Component dynamically. Attrs: type="events", theme="dark" |
3. Visual Look & Locked States
- 16:9 Media Aspect Ratio: Videos and photos render in crisp modern cards with subtle hover elevation and image zoom.
- Frosted Glass Locked Paywall: Locked content is masked with a frosted dark blur vignette (
rgba(0,0,0,0.65)) and a centered🔒badge. - Accented Unlock CTA: Displays a high-contrast button:
🔓 Unlock for R35.00. - Instant Inline Playback: Once unlocked, the card immediately transitions to reveal the native media player without reloading the page.
4. In-Page Modal Checkout Flow
All transactions occur inside a lightweight in-page modal without leaving your WordPress site:
- Click Unlock/Buy: The visitor clicks any buy, subscribe, or ticket button.
- Checkout Modal: An SSL modal displays the item title, ZAR price, and wallet balance.
- Account Linking: Visitors can link their Sponzar user ID once or pay via Instant EFT (Ozow).
- Automatic Un-blur: Upon payment confirmation, the modal closes and content un-blurs in 1.5 seconds.
5. Responsive Design & Dark Mode
- 🌙 Dark Mode: Automatically detects OS preferences (
prefers-color-scheme: dark) or switches manually. - 📱 Responsive Breakpoints: Automatically scales from 4/3 columns on desktop → 2 columns on tablet → 1 column on mobile screens.
- ⚡ Transient Caching: Automatically caches Sponzar API responses for 15 minutes to guarantee fast page loads.
Documentation & Manual
Read the complete technical manual in docs/wordpress_plugin_manual.md.
Embed SDK Guide 🧩
Access Layer™ Web Components
Embed any Sponzar feature onto any external website with a single line of HTML.
Open Interactive PlaygroundQuick Start (3 Steps)
- Go to Settings → Embed SDK and click Generate Token
- Select your scopes (Series, Music, Shop, Events, Vendors, etc.) and domain whitelist
- Paste on your website:
<script src="https://sponzar.africa/sdk/sdk.js" data-token="YOUR_EMBED_TOKEN"></script>
<!-- Tip: Use data-token="DEMO_TOKEN" for instant playground/sandbox testing -->
<!-- Add any component -->
<sponzar-series id="42" theme="dark"></sponzar-series>All 10 Web Components
| Component | Custom Tag | What It Does |
|---|---|---|
| 📺 TV / Micro-Drama | <sponzar-series> | Episode list, video player, frosted paywall overlay |
| 🎵 Music Album | <sponzar-music> | Album view, track list, audio player, track unlocks |
| 🎙️ Podcast | <sponzar-podcast> | Episodes with audio streaming and show notes |
| 💎 Subscriptions | <sponzar-subscribe> | Membership tier cards with 1-click recurring wallet checkout |
| 🛍️ Digital Shop | <sponzar-shop> | Product grid with instant buy & secure download link |
| 🎟️ Events / Tickets | <sponzar-events> | Event listing, ticket tiers, & instant QR ticket delivery |
| 📅 Appointments | <sponzar-booking> | Creator 1-on-1 services with date/time booking modal |
| 💚 Tip Jar | <sponzar-tip> | Direct tip jar with preset/custom Rand amounts |
| 🤝 Verified Vendors | <sponzar-vendors> | EventOS verified suppliers with Sponzar Escrow hire |
| 🌐 Universal App | <sponzar-app> | Polymorphic container that auto-delegates via type attribute |
Custom DOM Events
Listen to real-time checkout completions on your website for analytics and conversion tracking:
window.addEventListener('sponzar:ticket:purchased', (e) => {
console.log('Ticket Purchased:', e.detail);
// { event_id: 7, ticket_id: "TCK_123", amount: 150.00 }
});
window.addEventListener('sponzar:tip:sent', (e) => {
console.log('Tip Sent:', e.detail);
});
window.addEventListener('sponzar:content:unlocked', (e) => {
console.log('Content Unlocked:', e.detail);
});Theming & Customization
Components use Shadow DOM for total CSS isolation. Customize using attributes (theme="dark", primary-color="#609960") or CSS custom properties:
sponzar-series, sponzar-events {
--sp-primary: #609960;
--sp-accent: #39ff14;
--sp-radius: 14px;
}Full Embed SDK Documentation
Read the complete manual in docs/embed_sdk_manual.md.
EventOS & Vendor Operations 🎟️
1. Event Setup & Ticket Tiers
Organizers can create events under EventOS → Events. Configure ticket tiers (Early Bird, VIP, GA), capacity limits, and pricing. Tickets automatically generate secure QR codes upon purchase.
2. Vendor Portal & Sourcing
Verified event vendors (Staging, Sound, Catering, Security) can list their service catalog under EventOS → Vendors. Organizers can hire vendors via milestone contracts powered by Sponzar's EscrowOrchestrator.
3. External Website Integration
Sell tickets and showcase suppliers directly on your external website or WordPress blog:
- WordPress Shortcodes:
[sponzar_events],[sponzar_tickets event_id="7"], and[sponzar_vendors category="Sound"]. - Embed SDK Tags:
<sponzar-events>and<sponzar-vendors>. - Developer API v1:
GET /api/v1/tickets/eventsandPOST /api/v1/vendors/services/{id}/hire.
4. Gate Entry QR Scanner
Gate staff access the mobile scanner app at /event-os/scan. Point smartphone camera at attendee's ticket QR code for instant entry validation (Green = Valid, Red = Already Scanned/Invalid).
5. Revenue Settlement
Vendors and organizers track real-time sales settlements and request direct bank withdrawals under EventOS → Withdrawals.
Full Guides & Documentation
Read the step-by-step manuals in docs/event_os_user_manual.md and docs/vendor_operations_guide.md.
Stay in the loop
Get real-time alerts for tips, new messages, and when creators go live.