Instance / Config Properties (per-tenant)

Per-tenant configuration is loaded from the instances collection (instance.properties), keyed by the instanceId query parameter, and cached in memory for 5 minutes (up to 100 entries). A missing instance when instanceId is provided is a hard failure (INSTANCE_NOT_FOUND).

Property Applies to Effect
allowedOrderStatuses V2 PATCH Whitelist of statuses acceptable to PATCH /v2/orders/:orderId; empty array blocks all; unset → default V1 set
bypassWorkflowValidation V2 PATCH, order create/update, return true → skip workflow step-enforcement (step-jump) + suppress the workflow trigger event; only the terminal guard applies
addressValidator Order validation Optional external address-validation plugin
other properties.* Validators / extension points Arbitrary per-tenant config surfaced to domain validators & lifecycle extensions

bypassWorkflowValidation is a recognised instance property. Note: lifecycle extension pre/post hooks are currently disabledNOT CURRENTLY ENABLED / not wired.


Revision History
2026-08-05 | JP – Created the page and added the content.