Orders

Order place is the second reference integration. Same architecture as Customers.

Flow

1. POST /api/v1/orders (JWT, Operator+)
2. Persist orders, audit, outbox OrderCreated PENDING
3. Publisher produces to order.events (key = order id)
4. Consumer records message_history with Redis idempotency on header id

Request

{
  "customerEmail": "ada@example.com",
  "productSku": "SKU-1001",
  "quantity": 2,
  "notes": "Ship via express"
}

Topic order.events, DLT order.events.dlt. Headers: id, eventType, correlationId.

Try it

APIs → Experience.

If this fails

Same as customers: outbox not publishing, or DLT after consume failure. See Dead letters.