Updating Subscription Documentation is wrong

inLeague — Wed, 18 Sep 2019 14:27:09 GMT

I've complained recently about the docs being incomplete, inaccurate, or unreadable. Here's an example.

We are implementing API calls to update recurring subscriptions. This page has some details about doing so:

https://developer.authorize.net/api/reference/features/recurring_billing.html#Subscription_Status

Specifically:

The subscription start date (subscription.paymentSchedule.startDate) may only be updated if no successful payments have been completed.

The subscription interval information (subscription.paymentSchedule.interval.length and subscription.paymentSchedule.interval.unit) may not be updated.

The number of trial occurrences (subscription.paymentSchedule.trialOccurrences) may only be updated if the subscription has not yet begun or is still in the trial period.

But if we go to the API reference docs:

https://developer.authorize.net/api/reference/index.html#recurring-billing-update-a-subscription

These fields that either may not be updated or else may only conditionally be updated are all marked as required:

interval, length, startDate, etc.

It looks like somebody just copy-pasted the createSubscription request field docs.

topic Updating Subscription Documentation is wrong in Integration and Testing

Updating Subscription Documentation is wrong