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.

JavaScript
Python
Ruby
Go
PHP
Rust

Ready to start?

Head to the Quickstart guide to get your API key and make your first request.

Get Started