Skip to content
Last updated

Offer Mismatch

FieldValue
Type URIhttps://developer-next.ingrid.com/ingrid-api/errors/delivery/offer-mismatch
TitleOffer Mismatch
Recommended Status422 Unprocessable Entity

Description

The offer-mismatch error is returned when creating an order with a token whose offer hash does not match the submitted request. This means the fulfillmentGroups or destination sent to POST /v1/delivery/orders differ from what was originally sent to POST /v1/delivery/options when the token was generated.

Common Causes

  • The shopping cart contents changed after delivery options were fetched (items added, removed, or quantities changed)
  • The fulfillment group structure was modified (e.g., different SKUs, quantities, or group references)
  • The destination postal code or country code was altered between fetching options and creating the order

How to Resolve

  1. Re-fetch delivery options by calling POST /v1/delivery/options with the current cart and destination
  2. Present the updated delivery options to the customer
  3. Retry order creation with the fresh token from the new options response

Example Response

{
  "type": "https://developer-next.ingrid.com/ingrid-api/errors/delivery/offer-mismatch",
  "title": "Offer Mismatch",
  "status": 422,
  "detail": "The submitted fulfillment groups or destination do not match the offer encoded in the token. Please re-fetch delivery options and retry.",
  "trace_id": "abc-123-def-456"
}