# 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/marketfront/orders/validate`** — cart subtotal is less than `store.minimumOrderAmount`.
- **`POST /v1/marketfront/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/marketfront/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

```json
{
  "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/marketfront/orders/validate",
  "requestId": "req_abc123",
  "timestamp": "2026-04-27T14:30:00.000Z",
  "errorCode": "ORDER_BELOW_MINIMUM",
  "errorCategory": "validation",
  "retryable": false
}
```