Contents

expiration_intent

The reason a subscription expires.

Declaration

string expiration_intent

Possible Values

1

The customer canceled their subscription.

2

Billing error; for example, the customer’s payment information is no longer valid.

3

The customer didn’t consent to an auto-renewable subscription price increase that requires customer consent, allowing the subscription to expire.

4

The product wasn’t available for purchase at the time of renewal.

5

The subscription expired for some other reason.

Discussion

This field is returned in the JSON response, in the responseBody.Pending_renewal_info array.

You can use this value to do the following:

  • If the value is "1", decide whether to survey the subscribers who have opted in to an account on your system or show alternative subscription products within the same group. Decide whether to present a subscription offer to win back the user.

  • If the value is "2", decide whether to show the same or alternative subscription products because the user didn’t actively make the choice to unsubscribe.

For more information, see Engineering Subscriptions from WWDC 2018 and Implementing promotional offers in your app.

See Also

Dates and intent