Explore - Sponzar - Access Powered Revenue

All Channels Micro Dramas TV Series Music Podcasts Events Organisations Projects Communities Videos Articles

Micro Dramas

One Minute

One Minute

TV Series

Nandi - A Zulu Love Story

Nandi - A Zulu Love Story

Cultured Africa

Yanga

Yanga

Cultured Africa

Short one

Short one

Music

Our Jearney

Our Jearney

Bongumusa Siphamandla Nzuza

Gone

Gone

Soweto Lights

Soweto Lights

Podcasts

The Hustle Podcast

The Hustle Podcast

Events

Sponzar Launch Festival

Constitution Hill, Johannesburg

Community Feed

Pinned Post

Vejaxmusic @Vejaxmusic

#MinisterLindiwe #$ponzar #GIG

1 Image

You must subscribe to view this post.

0 likes 0 comments

Explore Creators

sawubonamusicjam

@sawubonamusicjam

@culturedafrica

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/content

Get 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 processed
subscription.created — A new subscription started
content.published — New content was posted
campaign.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.00

Step 2: Show paywall on your site if locked: "yes"

// Your frontend shows a "Buy" button with the price

Step 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=123

Subscriptions also work inline:

POST /api/v1/subscriptions
{ "user_id": 42, "creator_id": 7, "plan_interval": "monthly" }

💡 Key point: All payments are processed through the user's Sponzar wallet. No payment gateway integration needed on your site — Sponzar handles all the payment processing.

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.