1. Payments
Kabon Share API
  • Overview
  • MCP
  • Platforms
    • Bluesky
    • Instagram
    • Tiktok
    • Linkedin
    • Youtube
    • Facebook
    • Threads
    • Twitter
  • User Auth
    • Sign up
      POST
    • Verify email OTP
      POST
    • Resend OTP
      POST
    • Login with email & password
      POST
    • Sign in / sign up with Google
      POST
    • Request password reset email
      POST
    • Reset password with token
      POST
    • Refresh JWT token
      POST
  • Users
    • Get current user profile
      GET
    • Update current user profile
      PATCH
    • Get all user settings
      GET
    • Update publishing settings
      PATCH
    • Update notification settings
      PATCH
    • Update UI preferences
      PATCH
    • Get current billing usage
      GET
    • List saved payment methods
      GET
    • List billing transactions
      GET
    • Regenerate API key
      POST
    • Mark onboarding complete
      PATCH
    • Create a new user and get API key
      POST
    • Unregister a device from push notifications
      DELETE
    • Get list of registered devices
      GET
    • Register a device for push notifications
      POST
    • Send a test push notification to the current user
      POST
    • Remove the profile picture
      DELETE
    • Upload a profile picture. Stored in the avatars folder, served via the
      POST
    • Delete a payment method
      DELETE
    • Set a payment method as default
      PATCH
    • Download the invoice/receipt PDF for a captured (succeeded) transaction
      GET
  • Social Accounts
    • Get OAuth authorization URL
    • List connected social accounts
    • Disconnect a social account
    • Get creator info for an account
    • List available Facebook Pages
    • Connect a Facebook Page
    • List connected Facebook Pages for a workspace
    • List available LinkedIn organizations
    • Connect a LinkedIn organization
    • List a Pinterest account's boards
    • Create a new Pinterest board for the connected account
    • Validate TikTok creator info
    • Preview the scheduled posts that would be cancelled if this account is
  • Workspaces
    • List workspaces for current user
    • Create a workspace
    • Get a workspace
    • Update a workspace
    • Delete a workspace
    • Update workspace AI settings
  • Team
    • List available permission scopes
    • List pending invitations for the current user
    • Get invitation details by token
    • Accept a workspace invitation
    • Decline a workspace invitation
    • List workspace members
    • Invite a user to the workspace
    • List pending invitations for a workspace
    • Cancel / revoke an invitation
    • Resend an invitation email
    • Update member role / scopes
    • Remove a member from the workspace
    • Leave a workspace
    • Upload a single chat attachment (≤5 MB) to S3 and return { name, url, fileType }
    • Channels the user can see: all workspace channels + DMs they're a member of
    • Create a channel or DM
    • /
    • /
    • /
    • /
    • Get groups
    • Create groups
    • Delete groupId
    • Update groupId
    • Get roles
    • Create roles
    • Delete roleId
    • Update roleId
  • Posts
    • List posts
    • Create a post
    • List upcoming scheduled posts
    • Delete multiple posts
    • Get a post
    • Update a post
    • Delete a post
    • Get analytics for a post
    • Reschedule a post
    • Retry a failed post
    • Cancel a scheduled post
    • Publish a draft post
    • Submit a post for approval
    • Record an approval decision
    • Get post version history
    • Rich, board-ready view of everything in the approval pipeline for the
    • All posts belonging to one Bulk Scheduler batch, in schedule order
    • Summaries of every batch created by the Bulk Scheduler in this workspace —
    • Create bulk
    • Aggregated dashboard metrics computed across ALL posts in the workspace
    • Ping the pending approvers of the post's current open stage
    • /
    • Body: { body, mentions?: [userId], attachments? }
    • /
    • /
    • Deliberately release a 'ready' post (an immediate post that has cleared
  • Assets
    • List assets
    • Bulk delete assets
    • Upload asset directly (multipart)
    • Get signed upload URL (step 1 of 2)
    • Confirm signed upload (step 2 of 2)
    • Get storage usage summary
    • List asset folders
    • Create a folder
    • Rename a folder
    • Delete a folder
    • List asset tags
    • Check thumbnail generation status
    • Get an asset
    • Update asset metadata
    • Delete an asset
    • Batch-resolve asset metadata (name, type, url, thumbnail) for a list of IDs
  • Uploads
    • Get a signed upload URL for post media
    • Get upload file info
    • Delete an uploaded file
    • List uploads
    • Confirm upload complete
    • Create validate url
  • Analytics
    • Get platform aggregate stats
    • Get platform stats as a time series
    • Get audience demographics for a platform
    • List content analytics for a platform
    • Get analytics for a specific content item
    • Delete a synced content record
    • Get time series for a specific content item
    • Get follower count trend over time
    • Get recommended posting times per platform
    • Get aggregated analytics for a post across platforms
    • Gather data → render HTML → print to PDF (Puppeteer) → stream as a download
    • Generate the AI analysis on demand so the builder can preview it before export
    • For the report builder: gathers (and caches) the data, then returns the list of
    • Renders the analytics report as a self-contained HTML page so the template
  • Streams
    • List streams
    • Create a stream
    • Get a stream
    • Delete a stream
    • Go live
    • Stop a live stream
    • Broadcast from a file
    • Update a stream
    • Check relay health and list active paths
    • Get relay status for a specific stream
    • Get streaming usage for the authenticated user (minutes, limits, active streams)
    • the relay (path + token) and re-arm fan-out, returning the WHIP URL so
  • Plans
    • List available subscription plans
  • Subscriptions
    • Get current subscription & credit balances
    • Renew or extend subscription
    • Wallet balances and recent ledger entries
    • Cancel subscription
    • Choose the term for the next renewal
    • Turn recurring billing on or off. Body: { enabled: boolean }
    • Get extra accounts
    • Create cancel removal
    • Create remove
  • Support
    • List support tickets
    • Create a support ticket
    • Get ticket statistics
    • Get a ticket
    • Reply to a ticket
    • Upload a ticket attachment
  • AI
    • Generate caption & hashtags for a media asset
    • Transcribe audio or video
    • Poll async AI job status
    • Get saved captions for an asset
    • Get AI credit usage summary for the workspace
    • Get AI credit usage as a chart series
    • Derive AI style settings from past posts
    • /
    • /
    • /
    • /
    • /
    • /
    • ?limit=30 (default 30, max 100)
    • /
  • Studio
    • List studio projects
    • Create a studio project
    • Get a studio project (includes full projectData)
    • Update a studio project
    • Delete a studio project
  • Payments
    • Pay for a purchase with wallet credit
      POST
    • Charge a saved payment method (for recurring subscriptions or credit purchases)
      POST
    • Get payment configuration for frontend (public key, supported currencies, etc.)
      GET
    • Create cryptocurrency payment invoice via Heleket
      POST
    • Initialize a payment (subscription or credit purchase)
      POST
    • Verify a payment
      GET
  • Bluesky OAuth
    • atproto client metadata
    • atproto client public keys (JWKS)
    • atproto OAuth callback
  • Apps
    • Public — list all active apps with their latest active version
    • Public — single app with all active versions
    • Public — download/redirect to latest version
    • Public — download specific version
  • Billing
    • Get user's billing cycles (all statuses for full history)
    • Calculate proration for upgrading cycles (no charge, just preview)
    • Manually create billing cycles from an existing transaction (admin/fix tool)
    • Select a plan after account creation (for free plans or initial plan selection)
    • Upgrade billing cycles to a new plan with proration
    • Preview the discount a coupon yields for a subscription checkout, so the
  • Blog
    • Published categories with post counts
    • Published posts, newest first. Query: page, limit (max 100), category
    • Single published post by slug
  • Books
    • List available books (metadata only — no file data)
    • Download a book's full JSON data from storage (S3 or local)
  • Platforms
    • Returns obfuscated platform capabilities for frontend
    • Returns capabilities for a specific platform
  • Ideas
    • Get ideas
    • Create ideas
    • Get boards
    • Create boards
    • Delete boardId
    • Update boardId
    • Delete ideaId
    • Get ideaId
    • Update ideaId
    • Get comments
    • Create comments
    • Delete commentId
    • Create convert
    • Update move
    • Create vote
  • Notifications
    • The current user's notification inbox (newest first) + unread count
    • Mark all of the user's notifications read
    • Lightweight unread badge count
    • Mark a single notification read
  • Queue
    • Clean old jobs from the queue
    • Clear jobs from the queue
    • Drain the queue (remove all jobs)
    • Get all jobs in the queue
    • Get queue statistics
  • Limits
    • Create archive
    • Create unarchive
    • Create remove
    • Create restore
    • Create suspend
    • Get status
    • Create archive
    • Create unarchive
  • Services
    • List all available service names
    • Get status of all services (public endpoint)
    • Get status of a specific service (public endpoint)
  • Approvals
    • Delete approval flow
    • Get approval flow
    • Replace approval flow
    • Create resolve stage
  • Schemas
    • ApiResponse
    • SuccessResponse
    • ErrorResponse
    • Pagination
    • User
    • SocialAccount
    • Workspace
    • PlatformPost
    • PlatformValidationFailure
    • Asset
    • PostContentOverride
    • PostApproval
    • Ticket
    • Plan
    • Post
    • Stream
    • StudioProject
    • AiJob
    • WalletEntry
    • Subscription
  1. Payments

Pay for a purchase with wallet credit

POST
https://api.kabonshare.com/api/payments/pay-from-wallet
The amount is always computed server-side from the same helpers the card paths use, so paying by wallet can never cost a different price from paying by card.
The debit is atomic and all-or-nothing: a short balance returns 402 and nothing is taken, so the client can fall back to a card. A purchase is never split across two funding sources.
Not valid for wallet_deposit — funding the wallet from the wallet is circular and is rejected here, not merely hidden in the UI.

Request

Authorization
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Paid from wallet
Bodyapplication/json

🟠402
🟠400BadRequest
🟠401Unauthorized
🟠409Conflict
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kabonshare.com/api/payments/pay-from-wallet' \
--header 'Content-Type: application/json' \
--data '{
    "type": "subscription",
    "currency": "NGN",
    "planId": "string",
    "months": 1,
    "credits": 0,
    "accountSlots": 0
}'
Response Response Example
200 - Example 1
{
    "status": true,
    "message": "string",
    "data": {
        "transaction": {},
        "balance": 0
    }
}
Modified at 2026-08-16 16:05:56
Previous
Delete a studio project
Next
Charge a saved payment method (for recurring subscriptions or credit purchases)
Built with