Integration Guides
Practical, opinionated tutorials that walk through real BettaPay integrations end to end — from your first payment link to production webhooks and fiat settlement. Each guide stands on its own and links to the API reference where you need the details.
Accepting Your First Payment
The no-code path: create a merchant account, build a payment link, and collect a USDC payment with the Freighter wallet — end to end, no server required.
Server-to-Server Integration
Drive BettaPay from your backend: authenticate, create payments with idempotency keys, handle FX quotes, and reconcile status via polling or webhooks. Includes a complete Express.js server.
Webhook Handling & Retry Logic
Build a production-grade webhook receiver: HMAC-SHA256 signature verification in Node.js, Python, and PHP, idempotent deduplication, the BettaPay retry schedule, and a dead-letter queue.
Fiat Settlement Configuration
Configure SEP-24 anchors, run settlements from the dashboard or API, follow the PENDING → PROCESSING → COMPLETED lifecycle, and handle settlement webhooks and KYC requirements.
Testing with Stellar Testnet
Set up a repeatable testnet workflow: switch Freighter to testnet, fund accounts with friendbot, get test USDC, run a full test payment, and inspect transactions in Stellar Laboratory.