Send money from
any phone in
Africa
Stackr turns any mobile phone into a stablecoin wallet. Your users dial a USSD code to send money, pay bills, and cash out. No app download, internet connection, or smartphone is required.
One REST API. You integrate it. We handle Stellar, wallets, and settlement.
Interactive demo with sample amounts and outcomes. No backend calls or real payments. Use a sample PIN only.
REST
API Access
Explore all endpoints
<100ms
Avg Response
USSD-grade latency
2G
Min Phone
No internet needed
~5s
Settlement
Stellar finality
How it works
From dial to settlement in three steps. No app downloads, no blockchain knowledge, no internet connection required.
User dials a USSD code
No app needed. The user dials *384# from any phone, including feature phones and smartphones on 2G or 4G. No mobile data connection is needed; cellular service is required.
Stackr handles everything
Wallet lookup, signing, currency conversion, and settlement tracking. Pending payments are reconciled without rebuilding them.
Track payment settlement
The recipient gets a confirmation SMS. Funds settle on Stellar in USDC. Cash out at any supported anchor.
Everything your users need
A complete financial toolkit accessible from any phone. Integrate once and give your users access to all of these.
Send Money by Phone Number
Users send USDC to registered phone numbers within their operator. The backend handles wallet lookup, signing, spend reservations, and settlement recovery.
Pay Bills with USDC
Airtime, data, electricity, cable TV. Users pay in stablecoins, Stackr converts and delivers to local providers instantly.
Cash In / Cash Out
Deposit local currency to get USDC. Withdraw USDC to receive mobile money. Integrated with SEP-24 anchors for compliant fiat rails.
Merchant Payments
Configure merchant codes for your operator. Customers pay by entering the code on USSD. Instant USDC settlement, no POS hardware needed.
Token Swaps
USDC/XLM swaps through the classic Stellar DEX or an operator-configured Soroswap quote flow, with minimum output and settlement tracking.
Auto-Managed Wallets
Every phone number gets a Stellar wallet automatically. No seed phrases, no key management for end users. Fully custodial.
Integrate in minutes
Simple RESTful API. Get your API key, make a request, and you have stablecoin payments working. No blockchain knowledge required.
API examples run on your backend. Generate a fresh encrypted PIN for each request →
// Backend only. Import scripts/encrypt-pin.mjs from Stackr.
import { encryptPin } from './scripts/encrypt-pin.mjs';
const apiKey = process.env.STACKR_API_KEY;
const path = '/api/v1/transfers';
const paymentId = crypto.randomUUID(); // Create once per intended payment.
// Generate a fresh { version, timestamp, nonce, ciphertext } object.
const pin = encryptPin(process.env.STACKR_USER_PIN, apiKey, path);
const response = await fetch('https://api.usestackr.xyz' + path, {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': paymentId, // Persist this ID and reuse it on retries.
},
body: JSON.stringify({
sender_phone: '+250781234567',
recipient_phone: '+250789876543',
amount: 10.00,
pin, // Encrypted object; the raw PIN is never sent in this body.
}),
});
const result = await response.json();
// Example successful response
// { "tx_hash": "3d8f4a2b1c9e...", "status": "confirmed" }Why Stackr
Transparent infrastructure you can trust and verify.
Built on Stellar
Transactions settle on the Stellar network, a public, decentralized blockchain designed for payments. Fast, cheap, and auditable.
Open Source Backend
The Stackr engine is open source. Inspect the code, audit the logic, deploy your own instance. No black boxes.
USDC Stablecoin
USDC payments use the operator-configured asset and issuer. Wallets also hold XLM for network fees and swaps. Stablecoins and native assets carry financial risks.
Built in Rust
The backend is written in Rust with Actix-web. Memory safe, zero-cost abstractions, and the performance to handle USSD latency constraints.
Architecture
From USSD dial to Stellar settlement in milliseconds. Every layer is designed for the constraints of mobile money in Africa.
User dials *384# on any phone
│
Telco USSD Gateway
│
Africa's Talking (POST /ussd/callback)
│
┌─────▼──────┐
│ actix-web │──── IP allowlist + rate limiting (Redis)
└─────┬──────┘
│
USSD State Machine (Redis session + Postgres user lookup)
│
┌─────┼──────────────────┐
│ │ │
Stellar Postgres External APIs
───────── ──────── ─────────────
TX builder users SEP-24 anchors
transfers transactions CoinGecko (rates)
swaps anchor_orders Airbills (bills)
trustlines user_activity Africa's Talking (SMS)
fee bumps merchantsUSSD latency is sacred
Sessions timeout after ~30 seconds. Every handler responds fast. Heavy operations are fire-and-forget via tokio::spawn.
Config over code
Deploy to a new country by changing env vars. Currency, anchor, and shortcode are all configurable.
Atomic state transitions
Once an order reaches a terminal state (completed/error/expired), it cannot be changed. No double-credits.
Fail safe
If a bill payment API fails after debiting USDC, the system auto-refunds. Money is never silently lost.
Ready to give your users
stablecoin payments?
Get your API key in seconds. The free tier includes 1,000 calls per month to build and test your integration.
curl https://api.usestackr.xyz/healthTry it now. No API key needed.