Overview
High-level overview of the SplitPay collaborative payment protocol on Stellar.
SplitPay is an open, trustless, collaborative payment splitting and fund distribution protocol built natively on the Stellar network using Soroban smart contracts.
splitpay-web) and SDKs provide interfaces and off-chain caching, but never determine balances, authorizations, or distribution shares independently.What is SplitPay?
SplitPay eliminates trusted financial intermediaries for multi-party groups. Instead of one freelancer, team lead, or agency founder receiving client payments into a private wallet and manually computing and disbursing individual cuts, SplitPay routes incoming funds through an immutable on-chain pool.
When a payment is executed, the contract atomically calculates exact proportional disbursements and transfers assets directly to recipient addresses in a single blockchain transaction.
Why Stellar & Soroban?
Sub-Second Finality
Transactions settle in ~5 seconds with deterministic fees, making split payments practical even for small, frequent payouts.
Rust & WASM Safety
Soroban smart contracts are compiled to WebAssembly from Rust, providing type safety, memory safety, and checked integer arithmetic.
Ecosystem Overview
| Repository | Technology | Role in Ecosystem | Status |
|---|---|---|---|
| splitpay-contracts | Rust / Soroban v22 | On-chain financial authority, SEP-41 token interactions, immutable distributions | Active (Testnet) |
| splitpay-web | Next.js 16 / React 19 | Decentralized web application, Freighter wallet signing, pool management | Active |
| splitpay-mobile | React Native | Cross-platform mobile client for pool monitoring and on-the-go payment signing | Planning / Scaffolding |
| splitpay-sdk | TypeScript | Shared contract invocation library (First-party client inside web, standalone planned) | Client Implemented |
| splitpay-api | Node.js / REST | Off-chain indexing, webhook dispatches, and metadata cache | Planned |
Core Architectural Principles
- Financial Truth Lives On-Chain: All pool definitions, member shares, payments, and settled distributions reside in Soroban contract storage.
- Non-Custodial Architecture: SplitPay does not hold, custody, or bridge private keys. Users sign all invocations via Freighter or local keypairs.
- No Custom Token: SplitPay works directly with standard Stellar assets via the Stellar Asset Contract (SEP-41), including native XLM and fiat stablecoins like USDC.
- 10,000 Basis Points Precision: Splits are calculated in integer basis points (where 10,000 BPS equals 100.00%) with a deterministic zero-loss remainder policy.