Field billing_on in recurring app charge

Topic summary

Focus: How Shopify recurring charges handle billing_on, balance resets, and webhook behavior.

Key clarifications:

  • billing_on advances to the next billing date after a successful charge; it represents the start of the next billing cycle.
  • balance_used resets to 0 at the start of each new cycle for usage-based billing.
  • app_subscription_update does not fire when only billing_on changes; it triggers when the subscription itself is updated or canceled.

Operational guidance:

  • Implement a scheduled job (e.g., daily) to poll the recurring charge, detect billing_on changes, and update your app’s database or trigger internal actions.
  • Shopify does not provide a way to simulate recurring charges on development stores; real transactions are required to test the full billing cycle.

Open question:

  • Whether app_subscription_update triggers on status transitions such as FROZEN → ACTIVE (or to FROZEN) was asked and remains unanswered in the thread.

Status: Partially resolved with confirmed behaviors and recommended polling approach; one webhook-status-change question remains open.

Summarized with AI on January 17. AI used: gpt-5.

Hi Liam ,

that was an excellent answer.

will the app_subscription_update get triggered if status changes to “FROGEN” and “ACTIVE” from “FROGEN” ?