Soledgic Docs
Documentation
Build with Soledgic's platform payment infrastructure API for marketplaces, creator platforms, and closed-loop app economies.
What are you trying to do?
Start with a product job. The endpoint reference explains the exact call after that.
Create platform accounts
Add creators, buyer wallets, creator wallets, and the IDs your app will use later.
Take a purchase
Create checkout sessions for products, sessions, memberships, or in-app purchases.
Show wallet activity
Read balances, receipts, and transaction history for buyers, creators, and support teams.
Handle refunds
Route refund requests through Soledgic and keep platform fees, creator earnings, and holds aligned.
Pay creators
Check payout eligibility before any payout request, then track payout status.
Receive updates
Configure webhooks so your app is notified when important money events change.
curl -X POST https://api.soledgic.com/v1/participants \
-H "x-api-key: slk_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"participant_id": "creator_456",
"display_name": "Jane Creator",
"email": "jane@example.com",
"default_split_percent": 80
}'Universal integration flow
platform -> user wallet -> creator wallet -> product / session / order -> purchase -> platform fee + creator earnings -> refund / hold / reversal -> payout eligibility -> receipt / activity feed
Your app owns the user experience and product catalog. Soledgic owns the wallet, ledger, fees, earnings, refunds, holds, payout readiness, receipts, and audit trail.See the architecture details
Shared identity, participant linking, ecosystems, and fixture cleanup are operator control-plane features. They require authenticated dashboard sessions and are intentionally excluded from the public `/v1` API reference and the TypeScript SDK.
Quickstart
Create a participant, launch checkout, inspect balances, and send payouts
Authentication
Authenticate resource requests with API keys and environment isolation
Core Concepts
Understand the resource layer, ledger guarantees, holds, and replay safety
API Reference
Generated reference for treasury resources and supporting accounting APIs
API Examples
Copy-paste curl commands for every endpoint — test without an SDK
Error Reference
HTTP status codes, error codes, rate limiting, and idempotency behavior
Webhooks
Receive checkout, payout, and refund events from the platform
Bridge Operations
Run sandbox bridge smokes, trace deliveries, and clean test data
SDKs & Libraries
Use the TypeScript SDK or integrate directly over REST
Why Soledgic?
Resource-First Treasury API
Creator accounts, wallets, holds, checkouts, payouts, refunds, webhooks, receipts, and activity are the canonical public surface for new integrations.
Ledger Guarantees
Money movement maps to balanced entries and atomic database writes. The ledger either commits the full state change or nothing.
Built for Platform Economies
Model delayed release policies, creator balances, wallet transfers, and payout schedules without bolting treasury logic onto a checkout API.
Need help?
Start with the quickstart, then move into the API reference once your participant and checkout model is clear.