Subscription events

Subscriptions are created when the user places their order. After the user creates a subscription, they can update or cancel their subscription. AppDirect provides information about a customer's overdue or delinquent subscriptions.

Developers must register four URL endpoints to handle notifications for subscription management events. The Developer can use a URL for each event type or use a single URL to handle all event types. When an event occurs, AppDirect notifies the vendor by calling this URL, which is hosted by the vendor, and sends an eventUrl parameter. The eventUrl parameter identifies the location of an event, which the vendor can use to fetch information about that event. Upon notification, the vendor can perform an HTTP GET to the eventUrl to read an XML or JSON representation of the event.

Developers configure the subscription URL endpoints in the Edit Integration Settings section when they create their product, see Edit integration. AppDirect recommends HTTPS endpoints secured with SSL certificates.

See Configure product integration security for details on how to securely receive event notifications and retrieve event details.