What's the difference between cancellation and revocation?

There are two ways to end an entitlement and remove a customer's access to a service:

• The cancellation API
• The revocation API

The cancellation API triggers a "soft ending": the customer can continue to access the service until the end of the period for which they've already paid. The API requests the merchant to cancel the service at the end of the current billing cycle – normally the moment at which the customer would next make a payment to continue using the service.

The revocation API triggers a "hard ending": the customer loses access to the service immediately. For example, if a customer permanently deletes their account, you might want to revoke access to the service straight away.

Both approaches are valid, depending on requirements.