mufassall

Architecture / 3 / 4

Sagas and the outbox

One order needs a payment and a stock reservation in two other services, each with its own database. There is no single transaction to wrap it in. How to keep the three in agreement without locking the world.

  • 15 min
  • Advanced
  • 11 steps
Order p95
320 ms
Charged, no order
0 /day
Lost events
0 /day
Open in Lab
  • request
  • reply
  • redelivery
  • duplicate
  • lost

Numbers are a model scenario, not measurements

The real request

Shop app → Orders

Request

POST /orders HTTP/1.1
Host: api.example.com

{
  "customer_id": "u_42",
  "items": 1[{ "sku": "lamp-07", "qty": 2 }],
  "amount": 2500000
}

Response

HTTP/1.1 202 Accepted
{
  "order_id": "1042",
  "status": 3"pending"
}
  1. items — What to reserve in Inventory.
  2. amount — What to charge in Payments, in the smallest currency unit.
  3. status — pending: the order exists, but payment and stock are not settled yet.
Course: 42 lessons
  1. 01 Foundations

    1. The life of a request
    2. Latency and throughput
    3. Napkin math
  2. 02 Scaling

    1. Scaling up vs scaling out
    2. Load balancing
    3. Stateless servers
    4. Caching
    5. CDN and edge caching
  3. 03 Data & storage

    1. SQL and NoSQL
    2. Database indexes
    3. Storage engines: B-tree and LSM
    4. Database replication
    5. Sharding
    6. Consistent hashing
    7. Unique IDs
    8. CAP: when the link breaks
    9. Consensus and leader election
    10. Transactions
    11. File uploads
  4. 04 Communication

    1. API styles
    2. Message queues
    3. Pub/sub and event logs
    4. Real-time updates
    5. Reliable callbacks
  5. 05 Reliability

    1. Redundancy and failover
    2. Rate limiting
    3. Timeouts and retries
    4. Observability
  6. 06 Architecture

    1. Microservices
    2. Service discovery
    3. Sagas and the outbox
    4. Batch vs stream
  7. 07 Security

    1. Authentication
    2. Authorization
    3. Encryption and secrets
  8. 08 Shipping

    1. Testing
    2. CI/CD: from commit to production
  9. 09 Whole systems

    1. From requirements to design
    2. Design a URL shortener
    3. Design a news feed
    4. Design a chat
  10. 10 Business processes

    1. Payment gateway