Copy page

Errors

ORDER_BELOW_MINIMUM

ORDER_BELOW_MINIMUM

The order subtotal is below the merchant's configured minimum order amount.

Reserved error code — not currently emitted by any endpoint. Partners may begin handling it defensively; backend will start emitting once wired in.

Summary

Field	Value
HTTP status	400
errorCategory	validation
retryable	false

When This Fires

• POST /v1/marketplace/orders/validate — cart subtotal is less than store.minimumOrderAmount.
• POST /v1/marketplace/orders/place — same condition reaches placement.

Recommended Action

Surface the merchant's minimum to the user and let them add items to reach it:

1. Read store.minimumOrderAmount from the store details (GET /v1/marketplace/stores/{storeId}).
2. Show the gap to the user (e.g. "Add $4.50 more to reach the $15 minimum").
3. Allow them to add items, then resubmit.

Example

Code
{
  "type": "https://developer.gett-tech.com/errors/ORDER_BELOW_MINIMUM",
  "title": "Bad Request",
  "status": 400,
  "detail": "Order subtotal is below the merchant's minimum.",
  "instance": "/v1/marketplace/orders/validate",
  "requestId": "req_abc123",
  "timestamp": "2026-04-27T14:30:00.000Z",
  "errorCode": "ORDER_BELOW_MINIMUM",
  "errorCategory": "validation",
  "retryable": false
}