Skip to main content

Documentation Portal

Order Status Updates (from Merchant)

The UpdateOrderStatus API (Merchant to Global-e) lets you:

  • Cancel an order with a reason (and notify the customer accordingly)

  • Move an order to a processing status (used by Global‑e or specific cases not covered in this guide)

The following attributes are required in the system (OMS/ERP/MW) when executing the calls:

  • Global‑e order number (and not ecommerce platform or another system)

  • Status and reasons codes mapped on the Global‑e side (for example, for cancellation reasons)

Order Status Reasons

Important

Reasons (in addition to statuses) must be mapped in the Global‑e configuration so that appropriate notifications can be sent to the customer.

Possible cancellation reasons:

  • Cancellation because of out-of-stock

  • Cancellation at the customer’s request

  • Cancellation for technical reasons (default in case of no reason mapping declared)