Documentation
Everything you need to integrate Stackr's stablecoin payment API into your application.
How Stackr works
Stackr is a hosted API that handles stablecoin payments over USSD. You call our REST API from your backend. Stackr handles wallet management, Stellar transactions, and USSD session state.
Your App Stackr API Stellar Network
│ │ │
├── POST /v1/transfers ──────>│ │
│ (sender, recipient, amt) │── build + sign tx ──────────>│
│ │<── tx_hash ─────────────────│
│<── { tx_hash, status } ─────│ │
│ │ │
Your app never touches Stellar directly.
We handle wallets, fees, signing, and broadcasting.Key concepts
API Keys
Authenticate API v1 requests with an operator key issued by the backend administrator. The operator configuration selects the Stellar network; a key prefix does not select testnet or mainnet.
Phone-based wallets
Every phone number automatically gets a Stellar wallet. No setup needed from your users. Wallets are created on first use and managed entirely by Stackr.
Idempotency
Payment POSTs require a stable Idempotency-Key; quote-based swaps use quote_id. Signed payments are saved in Postgres before submission. Retry the same request with a fresh encrypted PIN envelope. HTTP 202 means settlement is pending.
USSD integration
If you want end users to interact via USSD menus (dial *384#), point your Africa's Talking callback URL to Stackr. Otherwise, use the REST API directly from your app.
Rate limits
The backend rate-limits USSD callbacks by source IP. PIN verification has a shared account-level attempt budget. API plan quotas and per-key throttling require a gateway integration.
Works with any language
Stackr is a standard REST API. No SDK required. Use curl, fetch, requests, or any HTTP client.
Ready to start?
Head to the Quickstart guide to get your API key and make your first request.
Get Started