Backend Integration Path
Connect your backend to Cardano - process payments, react to on-chain events, and build reliable integrations
Connect your backend services to the Cardano blockchain. This learning path teaches you how to detect payments, send transactions, and react to on-chain events in real-time.
Who This Path Is For
E-Commerce Platforms
Accept ADA payments and automatically fulfill orders when payments confirm.
SaaS Applications
Implement crypto billing for subscriptions and one-time purchases.
Gaming Platforms
Handle in-game currency top-ups and withdrawals.
NFT Marketplaces
Track sales, royalties, and payouts to creators.
Payment Gateways
Build merchant payment processing infrastructure.
Treasury Management
Monitor organizational wallets and automate reporting.
The Core Pattern
Every use case in this path follows the same fundamental pattern:
The Core Pattern
- Watch - Monitor the blockchain for relevant events (payments to your addresses)
- Process - Validate and store the data in your database
- React - Trigger actions in your application (fulfill orders, credit accounts)
- Confirm - Wait for sufficient confirmations before finalizing
What Makes Blockchain Integration Different
Challenge 1: No Webhooks
Blockchains don't push notifications to your server. You must either:
- Poll - Periodically query for changes (simple but inefficient)
- Stream - Maintain a WebSocket connection for real-time updates (efficient but more complex)
This path teaches you the streaming approach using chain synchronization.
Challenge 2: Eventual Consistency
Unlike traditional databases, blockchain state can temporarily "revert" due to chain reorganizations (rollbacks). A transaction that appeared confirmed might disappear if a competing block wins.
Your system must handle this gracefully - we'll show you how.
Challenge 3: Confirmation Latency
Transactions aren't instant. On Cardano:
| Confirmations | Time | Safety Level |
|---|---|---|
| 1 | ~20 seconds | Seen on chain |
| 6 | ~2 minutes | Safe for small amounts |
| 15 | ~5 minutes | Safe for most use cases |
| 30+ | ~10 minutes | Maximum security |
You'll learn how to show pending states to users while waiting for confirmation.
Prerequisites
Before starting, you should have:
- Backend development experience (any language)
- Basic understanding of databases and transactions
- Familiarity with WebSockets
- A Nacho API key from your dashboard
New to Cardano?
If you're unfamiliar with UTxOs and addresses, start with the Wallet Developer Path first. The concepts there are foundational.
Path Overview
1. Architecture Deep Dive
Understand the system design before writing code. Learn why each component exists and how they interact.
2. Payment Monitoring
Detect incoming payments in real-time using chain synchronization. Handle confirmations and rollbacks.
3. Sending Payments
Send ADA programmatically from your backend. Manage hot wallets, batch transactions, and optimize fees.
4. Production Patterns
Scale and harden your integration. High availability, monitoring, reconciliation, and disaster recovery.
Code Examples in 4 Languages
All tutorials include complete, runnable examples in:
Estimated Time
| Section | Time | Difficulty |
|---|---|---|
| Architecture | 15 min | Intermediate |
| Payment Monitoring | 25 min | Intermediate |
| Sending Payments | 25 min | Advanced |
| Production Patterns | 20 min | Advanced |
| Total | ~1.5 hours |
Ready to Start?
Start with Architecture
Was this page helpful?