checkout_retry
InactiveTool of ComOS Federation Gateway
Retry a failed or compensated checkout by restarting the saga from the beginning. **When to use:** When a checkout failed due to a transient issue that has been resolved (service timeout, temporary stock shortage). **Prerequisites:** - Saga must be in `failed` or `compensated` status - Original cart must still exist with items - Check `checkout_status` first to verify error is `retryable: true` **Behavior:** 1. Validates saga exists and is in retriable state 2. Re-validates cart still has items 3. Resets saga to `pending` status 4. Clears previous error and compensation records 5. Restarts saga execution from step 1 **CAN retry (transient failures):** - `INVENTORY_SERVICE_ERROR` - Service was temporarily unavailable - `PAYMENT_SERVICE_ERROR` - Stripe API had temporary issues - `ORDER_SERVICE_ERROR` - Order service timeout - `SAGA_TIMEOUT` - Processing exceeded time limit **CANNOT retry (permanent failures):** - `PAYMENT_DECLINED` - Customer needs different payment method - `INVALID_ADDRESS` - Customer must correct address - `CART_EMPTY` / `CART_NOT_FOUND` - Cart was cleared or deleted - `INVENTORY_UNAVAILABLE` - Items still out of stock (check first) **Cannot retry these statuses:** - `completed` - Already succeeded (start new checkout instead) - `in_progress` / `payment_pending` - Still active (Federated: requires tenant_id. For cart/orders, pass auth_token from POST /v1/auth/login. Product IDs are MongoDB ObjectIds from catalog_search.)
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tenant_id",
"sagaId"
],
"properties": {
"sagaId": {
"type": "string",
"description": "Checkout saga ID to retry"
},
"tenant_id": {
"type": "string",
"description": "Target tenant ID (required). Use federation_list_tenants() to see available tenants."
},
"auth_token": {
"type": "string",
"description": "JWT auth token for authenticated operations (cart, orders). Get from api_call POST /v1/auth/login."
}
},
"additionalProperties": false
}Parent server
ComOS Federation Gateway
https://github.com/ronrey/comos-federation
2/7 registries