This site uses cookies, by continuing to use the service, you accept our use of cookies Cookies Policy
Sponzar
View all
  • Explore
  • Micro Drama
  • TV Series
  • Music
  • Podcasts
  • Shop
  • User Manuals
  • Login
  • Getting started

Artist

Creators in this category

Categories
View all Animation Artist Designer Developer Drawing and Painting Others Photography Podcasts Video and Film Writing
Sipho Hotstix Mabuse
siphomabuse
  • 0
  • 1

Go to Page Free
Login to continue
Login with Facebook Login with X Login with Google
Don't have an account?
Two-Step Authentication
We have sent you a code to your email
Resend code
    Playing...
    User Manuals
    Creators
    Build your brand & earn
    Brands
    Launch campaigns & scale
    Fans
    Support & unlock access
    Developers
    API reference & docs
    WordPress
    Plugin & integration
    Embed SDK
    No-code embed widgets

    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
    ScopeAccess
    content.readList & view content, series, episodes, stream URLs
    content.writeCreate posts from external sites
    paymentsSubscriptions, tips, PPV purchases, payouts
    creators.readSearch and filter creators
    campaignsCreate and manage content reward campaigns
    webhooksRegister and manage webhook endpoints
    shopList and purchase products
    ticketsList events, buy & validate tickets
    bookingsList services, create & manage bookings
    *Full access (all scopes)
    Content Endpoints
    MethodEndpointDescription
    GET/api/v1/contentList posts (filter by type, access, creator)
    GET/api/v1/content/{id}Get single post
    POST/api/v1/contentCreate a new post
    GET/api/v1/content/{id}/streamGet signed media URLs
    Series Endpoints
    MethodEndpointDescription
    GET/api/v1/seriesList series (micro-dramas, TV, music, podcasts)
    GET/api/v1/series/{id}Series detail with episodes
    GET/api/v1/series/{id}/episodesList episodes with unlock status
    GET/api/v1/series/{sId}/episodes/{eId}/streamStream episode media
    POST/api/v1/series/{sId}/episodes/{eId}/purchaseBuy episode or season pass
    Monetization Endpoints
    MethodEndpointDescription
    POST/api/v1/subscriptionsSubscribe user to creator
    POST/api/v1/tipsSend a tip
    POST/api/v1/paymentsPPV purchase or wallet deposit
    POST/api/v1/payoutsRequest creator payout
    Other Endpoints
    MethodEndpointDescription
    GET/api/v1/creatorsSearch creators
    POST/api/v1/campaignsCreate campaign
    POST/api/v1/campaigns/{id}/assignAssign creators
    GET/api/v1/campaigns/{id}/performanceCampaign analytics
    POST/api/v1/webhooksRegister webhook endpoint
    Shop Endpoints
    MethodEndpointDescription
    GET/api/v1/shop/productsList products (filter by creator, category, type)
    GET/api/v1/shop/products/{id}Product detail with images & tier prices
    POST/api/v1/shop/products/{id}/purchaseBuy a product (wallet payment)
    Ticketing Endpoints
    MethodEndpointDescription
    GET/api/v1/tickets/eventsList events (ticket-type products)
    GET/api/v1/tickets/events/{id}Event detail with pricing rules
    POST/api/v1/tickets/events/{id}/purchaseBuy ticket(s) โ€” returns QR code
    GET/api/v1/tickets/mineList user's purchased tickets
    POST/api/v1/tickets/{id}/validateValidate/scan a ticket at event
    Booking Endpoints
    MethodEndpointDescription
    GET/api/v1/bookings/servicesList creator booking services
    GET/api/v1/bookings/services/{id}Service detail with extras & add-ons
    POST/api/v1/bookingsCreate booking (escrow payment)
    GET/api/v1/bookings/mineList user's bookings
    POST/api/v1/bookings/{id}/cancelCancel booking (escrow refund)
    Error Codes
    CodeErrorMeaning
    401api_key_requiredNo API key provided
    401invalid_api_keyKey doesn't exist
    402insufficient_balanceWallet balance too low
    403api_key_disabledKey deactivated
    403purchase_requiredContent 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
    1. Download the plugin ZIP file above
    2. In WordPress, go to Plugins โ†’ Add New โ†’ Upload Plugin
    3. Upload the ZIP and click Install Now
    4. Click Activate
    2. Configuration
    1. Go to Settings โ†’ Sponzar
    2. Enter your API Key (get it from the Sponzar admin panel โ†’ API Keys)
    3. Click Test Connection to verify
    4. Optionally set your default Creator ID and cache duration
    3. Shortcodes

    Add these shortcodes to any page or post:

    ShortcodeWhat 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)
    1. Go to Settings โ†’ Embed SDK and click Generate Token
    2. Select your scopes (Series, Music, Shop, etc.) and set your domain whitelist
    3. 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
    ComponentTagWhat 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
    AttributeValuesDefault
    themedark or lightdark
    primary-colorAny hex (e.g. #e74c3c)#6c5ce7
    powered-bytrue or falsetrue

    Components use Shadow DOM โ€” your website styles won't conflict with the embed.

    How Users Pay
    1. User clicks Buy/Subscribe/Tip on your website
    2. SDK shows a login modal โ€” user enters email or phone
    3. An OTP code is sent to verify identity (no passwords!)
    4. User chooses payment: Sponzar Wallet or Ozow (instant bank payment)
    5. Content unlocks instantly โ€” no page reload needed
    Token Scopes

    Control what each token can access:

    ScopeEnables
    seriesTV Series & Micro-Drama
    musicMusic albums & streaming
    podcastPodcast episodes
    subscribeSubscription tiers
    shopProducts & purchases
    eventsEvents & ticket sales
    bookingBooking services
    tipTipping
    checkoutWallet & Ozow payments
    analyticsView/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
    IssueFix
    "Loading..." foreverCheck 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 workingEnsure checkout scope is enabled
    Works Everywhere

    WordPress, Wix, Shopify, Squarespace, React, Vue, or plain HTML โ€” just paste the script and add components!