Change in Order payment terms does not trigger Order update webhook or show in GET Order response

Topic summary

Main issue: Changing an order’s payment terms in Shopify Admin (e.g., “Due on receipt” to “Net 90”) does not trigger an order update webhook, and the REST Admin API still returns the old payment_terms_name, even though the Admin UI reflects the new term.

Context: The integration only syncs orders that are paid or have fixed payment terms, relying on order/create and order/update webhooks. Missing the payment terms change prevents the workflow from running.

Key questions: Is this behavior a bug? How can apps be notified when payment terms change?

Suggestions offered:

  • Check webhook configuration/scopes to ensure order update events cover payment term changes.
  • Add periodic polling via the REST Admin API to detect payment_terms changes for previously ineligible orders.
  • Implement a custom trigger to emit a webhook when payment terms are edited.
  • Consider third-party tools that track granular order changes.

Definitions: Webhook = server callback on specific events; REST Admin API = Shopify’s HTTP API; payment terms = agreed schedule for payment (e.g., Net 90).

Status: No confirmed resolution; remains open with workarounds proposed.

Summarized with AI on December 18. AI used: gpt-5.

I am working on a Shopify integration to a warehousing system. One of the requirements is to only sync orders that are paid or have fixed payment terms.

We have Order create, and Order update webhook notifications configured to trigger the integration workflow. But do not receive any order update notification when payment terms are changed.

For example if we create an order with “Due on receipt” payment terms:

On order creation we receive the webhooks but do not integrate as payment terms do not meet criteria.

Then if we edit the order through Shopify Admin UI, changing the payment terms to “Net 90” there is no Order update notification webhook sent.

Using the REST Admin API to Retrieve the specific order, the payment_terms_name still shows “Due on receipt”.

Shopify Admin UI still shows “Net 90” after refreshing the order page.

Is this a bug? Is there some other way to be notified of an Orders payment terms changing?

Hi @z832 :

Alvina from AdVision eCommerce here, It sounds like you’re running into an issue with webhook notifications not firing when the payment terms on an order are changed. This could be related to how Shopify handles order updates and triggers webhooks for certain actions but not others.

Here are a few possible solutions you can try:

  • Check Webhook Scopes: Ensure that the webhook for “Order update” includes changes to payment terms specifically. Sometimes the scope of the webhook may not cover certain fields.

  • Manual Polling: If the webhook doesn’t trigger on payment term updates, consider setting up periodic polling using the Shopify REST Admin API to check for changes in payment terms for orders that didn’t initially meet your criteria.

  • Custom Webhook Trigger: You could explore creating a custom trigger that sends a webhook whenever a specific event, like payment terms being edited, occurs. This may require more custom development but could solve the issue.

  • Alternative Webhooks: If Shopify’s native webhook doesn’t send the update, you might also want to explore using a third-party app or API integration that tracks order changes more thoroughly.

Hope this helps!

Thank you.