Documentation or meaning of the pending_renewal_info attribute in an In-App Purchase receipt?

Viewed 3472

Has anyone encountered the pending_renewal_info attribute while validating a receipt for an In-App Purchase or can anyone point to documentation regarding this field?

I have looked at the Apple documentation for Receipt Validation but do not see any references to this field which our system encountered for the first time today and flagged as being an unknown field. I am looking for any information to understand what it means and what action I should take.

2 Answers

It is documented at responseBody.Pending_renewal_info.

The most important info it contains IMO is grace_period_expires_date_ms which can be used to determine whether the subscription is in the grace period and is_in_billing_retry_period which determines whether Apple is trying to renew the subscription or not.

Discussion section:

In the JSON file, pending_renewal_info is an array in which each element contains the pending renewal information for each auto-renewable subscription identified by the product_id. A pending renewal may refer to a renewal that is scheduled in the future or a renewal that failed in the past for some reason. It is only returned for app receipts that contain auto-renewable subscriptions.

You can use this value to get critical information about any pending renewal transactions for an auto-renewable subscription.

Refer Engineering Subscriptions video from WWDC 2019 for more information.

Related