# Send order status template message | Developer Documentation

<div id="bkmrk-send-order-status-te">## Send order status template message

<div><span>Updated: Nov 14, 2025</span></div><div id="bkmrk-overview"><div id="bkmrk-overview-1"><div>### Overview

</div></div></div><div>An Order status template is a template with interactive [components](/books/meta-whatsapp/page/template-components-developer-documentation) that extends the call-to-action button to support updating order status through a template. It allows the businesses to update the order status outside of the [customer session window](/books/meta-whatsapp/page/sending-messages-developer-documentation) in use cases such as charging the card for past order and updating about a shipment on order placed in the past.</div><div>Upon receiving the payment signals, the businesses must update the order status to keep the user up to date. Currently we support the following order status values</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-l52f0oty.jpeg)</div><div><table><thead><tr><th><span>Value </span></th><th><span>Description </span></th></tr></thead><tbody><tr><td><div><div>`pending`</div></div></td><td><div><div>User has not successfully paid yet</div></div></td></tr><tr><td><div><div>`processing`</div></div></td><td><div><div>User payment authorized, merchant/partner is fulfilling the order, performing service, etc.</div></div></td></tr><tr><td><div><div>`partially-shipped`</div></div></td><td><div><div>A portion of the products in the order have been shipped by the merchant</div></div></td></tr><tr><td><div><div>`shipped`</div></div></td><td><div><div>All the products in the order have been shipped by the merchant</div></div></td></tr><tr><td><div><div>`completed`</div></div></td><td><div><div>The order is completed and no further action is expected from the user or the partner/merchant</div></div></td></tr><tr><td><div><div>`canceled`</div></div></td><td><div><div>The partner/merchant would like to cancel the `order_details` message for the order/invoice. The status update will fail if there is already a `successful` or `pending` payment for this `order_details` message</div></div></td></tr></tbody></table>

</div><div id="bkmrk-creating-an-order-st"><div id="bkmrk-creating-an-order-st-1"><div>### Creating an order status template

</div></div></div><div>To create an order status template, the business needs a business portfolio with a WhatsApp Business Account, and access to the WhatsApp Manager.</div><div>In **WhatsApp Manager** &gt; **Account tools**:</div><span>Click on `create template`</span><span>Select `Utility` category to expand `Order details message` option</span><span>Enter the desired `template name` and supported `locale`</span> <span>Depending on the number of `locales` selected there will be an equal number of template variants and businesses need to fill in the template details in respective locale.</span><span>Please fill in template components such as `Body` and optional `footer` text and submit.</span><span>Once submitted, templates will be [categorized as per the guidelines](/books/meta-whatsapp/page/template-categorization-developer-documentation) and undergo the [approval process](/books/meta-whatsapp/page/template-review-developer-documentation) refrain from having [marketing content](/books/meta-whatsapp/page/template-categorization-developer-documentation) as part of template components.</span><span>The template will be approved or rejected after the template components are verified by the system. </span><span>If business believe the category determined is not consistent with our template category guidelines, please confirm there are no [common issues](/books/meta-whatsapp/page/template-review-developer-documentation) that leads to rejections and if you are looking for further clarification you may [request a review](/books/meta-whatsapp/page/template-categorization-developer-documentation) of the template via [Business Support<span>?</span>](https://business.facebook.com/business-support-home/)</span><span>Once approved template [status](/books/meta-whatsapp/page/templates-developer-documentation) will be changed to `ACTIVE`</span> <span>Please be informed that template's status can change automatically from `ACTIVE` to `PAUSED` or `DISABLED` based on customer feedback and engagement. We recommend that you [monitor status changes](/books/meta-whatsapp/page/template-review-developer-documentation) and take appropriate actions whenever such change occurs.</span><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-r7peyd1l.gif)</div><div id="bkmrk-sending-order-status"><div id="bkmrk-sending-order-status-1"><div>### Sending order status template message

</div></div></div><div>Order status template message allows the businesses to send update on the status of the order as template component parameters.</div><div>To send an order status template message, make a `POST` call to `/<PHONE_NUMBER_ID>/messages` endpoint and attach a message object with `type=template`. Then, add a [template object](/books/meta-whatsapp/page/sending-messages-developer-documentation) with a `order_status` component and parameters with latest status on order with order `reference-id`.</div><div>For example, the following sample describes how to send `shipped` status on the placed order.</div><div>Upon sending an `order_status` message with an invalid transition, you will receive an error webhook with the error code `2046` and message `New order status was not correctly transitioned`.</div><div id="bkmrk-canceling-an-order"><div id="bkmrk-canceling-an-order-1"><div>### Canceling an order

</div></div></div><div>An order can be canceled by sending an `order_status` message with the status `canceled`. The customer cannot pay for an order that is canceled. The customer receives an `order_status` message and the order details page is updated to show that the order is canceled and the `Continue` button removed. The optional text shown below `Order canceled` on the order details page can be specified using the description field in the `order_status` message.</div><div>An order can be canceled only if the user has not already paid for the order. If the user has paid and the business sends a order_status message with canceled status will receive an error webhook with error code `2047` and message `Could not change order status to 'canceled'`.</div></div>