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) |
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
Embed your Sponzar content on any WordPress website. Includes content grids, series players, creator profiles, and a full inline purchase flow.
Download Plugin (ZIP)Version 1.0.0 · Compatible with WordPress 5.6+
1. Installation
- Download the plugin ZIP file above
- In WordPress, go to Plugins → Add New → Upload Plugin
- Upload the ZIP and click Install Now
- Click Activate
2. Configuration
- Go to Settings → Sponzar
- Enter your API Key (get it from the Sponzar admin panel → API Keys)
- Click Test Connection to verify
- Optionally set your default Creator ID and cache duration
3. Shortcodes
Add these shortcodes to any page or post:
| Shortcode | What It Does |
|---|---|
[sponzar_content] | Grid of your posts (photos, videos, audio) |
[sponzar_series type="podcast"] | Grid of series (podcast, music_album, tv_series, micro_drama) |
[sponzar_series_detail id="42"] | Full series page with episodes and buy buttons |
[sponzar_creators] | Creator directory with subscribe buttons |
Common attributes: per_page, columns, type, creator_id
4. Inline Purchases
Locked content displays buy buttons automatically. Visitors can:
- 🔓 Unlock PPV content — one-click purchase from their Sponzar wallet
- 🎬 Buy episodes or season passes — directly on the episode list
- ⭐ Subscribe to creators — choose a plan from the creator card
On first purchase, visitors link their Sponzar account by entering their User ID once.
5. Features
- 🌙 Dark mode — automatic via system preference
- 📱 Responsive — looks great on all devices
- ⚡ Cached — responses cached for 15 minutes to reduce API calls
- 🔒 Secure — nonce verification on all AJAX calls
Need Help?
Contact support for assistance with API integration or plugin setup.
Embed SDK Guide 🧩
Quick Start (3 Steps)
- Go to Settings → Embed SDK and click Generate Token
- Select your scopes (Series, Music, Shop, etc.) and set your domain whitelist
- Paste on your website:
<script src="https://sponzar.africa/sdk/sdk.js" data-token="YOUR_TOKEN"></script>
<!-- Add any component -->
<sponzar-series id="42" theme="dark"></sponzar-series>That's it! The SDK auto-initializes, fetches your content, and renders a premium UI.
Available Components
| Component | Tag | What It Does |
|---|---|---|
| 📺 TV Series | <sponzar-series> | Episode list, video player, gated content |
| 🎵 Music | <sponzar-music> | Album view, track list, audio player |
| 🎙️ Podcast | <sponzar-podcast> | Episodes with audio streaming |
| 💎 Subscribe | <sponzar-subscribe> | Tier cards with one-click subscribe |
| 🛍️ Shop | <sponzar-shop> | Product grid with buy button |
| 🎟️ Events | <sponzar-events> | Event listing + ticket purchase + QR codes |
| 📅 Booking | <sponzar-booking> | Creator services with pricing |
| 💜 Tip | <sponzar-tip> | Tip jar with preset/custom amounts |
Component Examples
Copy any snippet and paste it on your website after the SDK script:
<!-- TV Series / Micro-Drama -->
<sponzar-series id="42" theme="dark"></sponzar-series>
<!-- Music Album -->
<sponzar-music id="15" theme="dark"></sponzar-music>
<!-- Podcast -->
<sponzar-podcast id="7" theme="dark"></sponzar-podcast>
<!-- Subscription Tiers -->
<sponzar-subscribe theme="dark"></sponzar-subscribe>
<!-- Shop Products -->
<sponzar-shop theme="dark"></sponzar-shop>
<!-- Events / Ticketing -->
<sponzar-events theme="dark"></sponzar-events>
<!-- Creator Booking -->
<sponzar-booking theme="dark"></sponzar-booking>
<!-- Tip Jar (custom amounts) -->
<sponzar-tip amounts="10,25,50,100" theme="dark"></sponzar-tip>Theming & Customization
| Attribute | Values | Default |
|---|---|---|
theme | dark or light | dark |
primary-color | Any hex (e.g. #e74c3c) | #6c5ce7 |
powered-by | true or false | true |
Components use Shadow DOM — your website styles won't conflict with the embed.
How Users Pay
- User clicks Buy/Subscribe/Tip on your website
- SDK shows a login modal — user enters email or phone
- An OTP code is sent to verify identity (no passwords!)
- User chooses payment: Sponzar Wallet or Ozow (instant bank payment)
- Content unlocks instantly — no page reload needed
Token Scopes
Control what each token can access:
| Scope | Enables |
|---|---|
series | TV Series & Micro-Drama |
music | Music albums & streaming |
podcast | Podcast episodes |
subscribe | Subscription tiers |
shop | Products & purchases |
events | Events & ticket sales |
booking | Booking services |
tip | Tipping |
checkout | Wallet & Ozow payments |
analytics | View/play/purchase tracking |
Domain Whitelist
Restrict your token to specific domains for security:
example.com— exact match*.example.com— all subdomains- Leave empty → allow all domains
Analytics
The SDK automatically tracks views, plays, checkouts, and sales. View your analytics on the Settings → Embed SDK dashboard.
Troubleshooting
| Issue | Fix |
|---|---|
| "Loading..." forever | Check browser console for token/CORS errors |
| "Scope not allowed" | Add the scope to your token in Settings |
| "Domain not whitelisted" | Add your domain or leave whitelist empty |
| Checkout not working | Ensure checkout scope is enabled |
Works Everywhere
WordPress, Wix, Shopify, Squarespace, React, Vue, or plain HTML — just paste the script and add components!
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 & Sales
Event vendors access their dedicated stall portal at /event-os/vendor/dashboard. Assign staff members, process food/beverage or merch sales, and view live earnings balances.
3. 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).
4. Revenue Settlement
Vendors and organizers track real-time sales settlements and request direct bank withdrawals under EventOS → Withdrawals.
Full Guide & Documentation
Read the full step-by-step EventOS manual in docs/event_os_user_manual.md.
Stay in the loop
Get real-time alerts for tips, new messages, and when creators go live.