App Store Connect Help

Support / App Store Connect / Manage subscriptions / Enable billing grace period for auto-renewable subscriptions

Manage subscriptions

Enable Billing Grace Period for auto-renewable subscriptions

Billing Grace Period lets subscribers whose auto-renewal failed due to a payment issue continue accessing your app’s paid content for a period of time while Apple continues to attempt to collect payment. There won’t be any interruption to the subscriber’s days of paid service or to your revenue if Apple recovers the subscription within the grace period. Without enabling Billing Grace Period, the subscriber’s days of paid service pause until Apple is able to collect payment.

Note: It may take up to 1 hour for changes you make to product metadata to appear in the sandbox environment.

You can configure grace periods in App Store Connect using the App Store Connect API.

Workflow for enabling Billing Grace Period

Enabling Billing Grace Period requires you turn on and complete configurations in App Store Connect, and use StoreKit to verify subscribers’ renewal states so they retain access to subscription content while in the billing retry state.

The following workflow can be used to properly test and validate your server to app’s logic before fully rolling out the feature to your subscribers.

  1. Turn on Billing Grace Period in sandbox.

    Make sure to do this only before turning it on in production.

  2. Test Billing Grace Period in sandbox.

    Use the sandbox environment to validate your client and server logic to handle subscribers entering and exiting the grace period. View implementation guidance.

  3. Turn on Billing Grace Period in production.

    Once you validate your client and server logic, edit your Billing Grace Period configuration to support the production environment.

Required role: Account Holder, Admin or App Manager. View role permissions.