Submit Checkout
POST/api/portal/checkout
Submit the active cart. The cart is re-priced and re-validated; the location's minimum order value is enforced (422 below it). If the account's approval policy requires it, an approval request is created (status pending_approval, no order yet); otherwise a draft order is created and the cart is emptied. ship_to_address_id (or an inline ship_to), customer_po_number, requested_delivery_date, shipping_method_id, note, and payment_method are accepted.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.