> ## Documentation Index > Fetch the complete documentation index at: https://enterprise-docs.bglobale.com/llms.txt > Use this file to discover all available pages before exploring further. # Update Order Status (from Global-e) > Global-e posts the order status to a merchant-hosted endpoint via the UpdateOrderStatus (Global-e to Merchant) API. Part of the [Order Status Updates (from Global‑e)](/order-status-updates--ge-to-m-) integration guide — see it for when and how to use this endpoint. ## OpenAPI ````yaml api-reference/specs/updateorderstatusfromglobale.yaml POST /order-status-update-url openapi: 3.0.3 info: title: UpdateOrderStatus (Global-e to Merchant) version: 1.0.0 description: >- The UpdateOrderStatus API (Global-e to Merchant direction) updates the order status on the merchant's site. Global-e posts the order details to a merchant-hosted endpoint. Only order.OrderId and order.StatusCode members are mandatory for this method. servers: - url: https://{merchant_site_domain} variables: merchant_site_domain: default: www.merchant-site-domain.com description: The merchant's site domain hosting the order-status-update endpoint. security: [] tags: - name: UpdateOrderStatus (Global-e to Merchant) x-page-title: Update Order Status (from Global-e) - name: 'Direction: Global-e → Merchant' - name: 'Domain: Orders' paths: /order-status-update-url: post: tags: - UpdateOrderStatus (Global-e to Merchant) summary: Update Order Status (from Global-e) description: >- This API updates the order status on the merchant's site. Only order.OrderId and order.StatusCode members are mandatory for this method. The UpdateOrderStatus API lets you cancel an order with a reason (and notify the customer accordingly) or move an order to a processing status (used by Global‑e or specific cases not covered in this guide). operationId: updateOrderStatusFromGlobale requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MerchantOrder' example: OrderId: GE10047946955SG StatusCode: CANCELLED MerchantGUID: 0511db1d-cdc6 CartId: 52c615003faea0995 MerchantOrderId: '00024345' MerchantInternalOrderId: '00024345' PriceCoefficientRate: 1 CartHash: ICEzF5/PznED/VyE= WebStoreCode: shop WebStoreInstanceCode: www.qa.shop.asia DiscountedShippingPrice: 7.12 InternationalDetails: CurrencyCode: SGD TotalPrice: 29.9 TransactionCurrencyCode: SGD TransactionTotalPrice: 29.9 TotalShippingPrice: 4.16 SameDayDispatchCost: 0 TotalCCFPrice: 0 TotalDutiesPrice: 0 USSalesTax: 0 ShippingMethodCode: STANDARD_APAC ShippingMethodName: Ship-GlobalE PaymentMethodCode: '1' PaymentMethodName: Visa CardNumberLastFourDigits: '1111' ExpirationDate: 2030-3-31 DutiesGuaranteed: false OrderTrackingNumber: null OrderTrackingUrl: >- https%3a%2f%2fwww2.bglobale.com%2fOrder%2fTrack%2fmZVW%3fOrderId%3dGE10047946955SG% OrderWaybillNumber: null ShippingMethodTypeCode: Standard ShippingMethodTypeName: Standard Courier DeliveryDaysFrom: 2 DeliveryDaysTo: 3 ConsignmentFee: 0 SizeOverchargeValue: 0 RemoteAreaSurcharge: 0 DiscountedShippingPrice: 10 CashOnDeliveryFee: 0 ParcelsTracking: [] TotalVATAmount: 1.95 ShippingVATRate: 7 ShippingMethodStatusCode: Undefined ShippingMethodStatusName: undefined ShipmentStatusUpdateTime: null ShipmentLocation: null GiftCards: null DeclarativeShippingPriceInCustomerCurrency: null TotalValueForCustoms: null TaxCalculationRule: null responses: '200': description: >- Success or failure. Check the `Success` field to distinguish. On failure, `Message` and `Description` carry the error text. content: application/json: schema: $ref: '#/components/schemas/ResponseInfo' examples: success: summary: Success Response value: action: Globale-OrderUpdateStatus queryString: '' locale: en_SG InternalOrderId: '00024345' OrderId: '00024345' Success: true ErrorCode: null Message: null Description: null failure: summary: Failure Response value: Success: false Message: error message Description: error description components: schemas: MerchantOrder: type: object title: Merchant.Order description: >- Provides full details for the merchant order. Only OrderId and StatusCode are mandatory; requests can contain more parameters than listed. additionalProperties: true required: - OrderId - StatusCode properties: OrderId: type: string description: Global‑e order unique identifier. StatusCode: type: string description: >- Code denoting the order status. Only OrderId and StatusCode are mandatory for this method. MerchantGUID: type: string description: Merchant's unique identifier (present in the worked example). CartId: type: string MerchantOrderId: type: string MerchantInternalOrderId: type: string PriceCoefficientRate: type: number CartHash: type: string WebStoreCode: type: string WebStoreInstanceCode: type: string DiscountedShippingPrice: type: number InternationalDetails: $ref: '#/components/schemas/InternationalDetails' GiftCards: type: array nullable: true items: {} description: Null in the worked example; element shape not documented. DeclarativeShippingPriceInCustomerCurrency: type: number nullable: true TotalValueForCustoms: type: number nullable: true TaxCalculationRule: type: string nullable: true ResponseInfo: type: object title: ResponseInfo description: Provides details regarding the API call response. properties: action: type: string description: The action name (present in the worked success example). queryString: type: string description: Query string echoed back (present in the worked success example). locale: type: string description: Locale of the order (present in the worked success example). InternalOrderId: type: string description: Order unique identifier on the Merchant's site. OrderId: type: string description: Order identifier on the Merchant's site. Success: type: boolean description: >- Indicates if the call has succeeded. TRUE - Call succeeded. FALSE - Denotes an error or failure. ErrorCode: type: string nullable: true description: Error code to be returned when an error occurs. Message: type: string nullable: true description: >- Optional response message. In case of an error, this property indicates the error message text. Description: type: string nullable: true description: >- Optional response description. In case of an error, this property indicates the error message description. InternationalDetails: type: object title: InternationalDetails description: >- International order details. Inferred entirely from the worked example (no field table on the page); types inferred from the example values. See review §2. properties: CurrencyCode: type: string TotalPrice: type: number TransactionCurrencyCode: type: string TransactionTotalPrice: type: number TotalShippingPrice: type: number SameDayDispatchCost: type: number TotalCCFPrice: type: number TotalDutiesPrice: type: number USSalesTax: type: number ShippingMethodCode: type: string ShippingMethodName: type: string PaymentMethodCode: type: string PaymentMethodName: type: string CardNumberLastFourDigits: type: string ExpirationDate: type: string DutiesGuaranteed: type: boolean OrderTrackingNumber: type: string nullable: true OrderTrackingUrl: type: string OrderWaybillNumber: type: string nullable: true ShippingMethodTypeCode: type: string ShippingMethodTypeName: type: string DeliveryDaysFrom: type: integer DeliveryDaysTo: type: integer ConsignmentFee: type: number SizeOverchargeValue: type: number RemoteAreaSurcharge: type: number DiscountedShippingPrice: type: number CashOnDeliveryFee: type: number ParcelsTracking: type: array items: {} description: Empty in the worked example; element shape not documented. TotalVATAmount: type: number ShippingVATRate: type: number ShippingMethodStatusCode: type: string ShippingMethodStatusName: type: string ShipmentStatusUpdateTime: type: string nullable: true ShipmentLocation: type: string nullable: true ````