checkout_select_shipping
InactiveTool of ComOS Federation Gateway
Select a shipping method for a checkout. **When to use:** After `checkout_shipping_options`, when customer has chosen their preferred shipping method. **Prerequisites:** - Must call `checkout_shipping_options` first to get valid carrierId/serviceId combinations - Checkout must be in `pending` or `payment_pending` status **Behavior:** - Updates the checkout's shipping method and recalculates total - Can be called multiple times to change selection (before payment) - Invalid carrierId/serviceId combinations will error **Returns:** Selected shipping details and updated order total. **This step is OPTIONAL.** If skipped entirely (no `checkout_shipping_options` or `checkout_select_shipping`), a default shipping method is applied automatically. (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",
"carrierId",
"serviceId"
],
"properties": {
"sagaId": {
"type": "string",
"description": "Checkout saga ID"
},
"carrierId": {
"type": "string",
"description": "Carrier ID from shipping options (e.g., 'fedex', 'ups')"
},
"serviceId": {
"type": "string",
"description": "Service ID from shipping options (e.g., 'ground', 'express')"
},
"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
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
ComOS Federation Gateway
https://github.com/ronrey/comos-federation
2/7 registries