checkout_status

Tool of ComOS Federation Gateway

Get the current status of a checkout saga, including completed steps, errors, and order details. **When to use:** - After `checkout_start` to track async saga progress - After customer completes Stripe payment to verify order completion - To debug failed checkouts and determine if retry is appropriate **Saga Status Values:** | Status | Meaning | |--------|---------| | `pending` | Checkout created, cart validated, awaiting processing | | `in_progress` | Saga actively executing (inventory reservation, order creation, etc.) | | `payment_pending` | Pre-payment steps complete, awaiting Stripe payment | | `completed` | Payment successful, order confirmed. Terminal success state | | `failed` | A step failed. Check `error` field for details | | `compensated` | Rollback complete (inventory released, refunds issued). Terminal failure state | **Saga Steps (execution order):** 1. `validate_cart` - Verify cart exists and has items 2. `reserve_inventory` - Place hold on product stock 3. `create_order` - Create order record 4. `process_payment` - Charge payment (or await Stripe session) 5. `confirm_order` - Finalize order, trigger fulfillment 6. `send_confirmation` - Email customer 7. `clear_cart` - Remove purchased items **Response includes:** completedSteps, currentStep (if in_progress), error details (if failed), compensation info (if rolled back), and order/payment IDs (if created). (Federated: requires tenant_id. For cart/orders, pass auth_token from POST /v1/auth/login. Product IDs are MongoDB ObjectIds from catalog_search.)