|
Table of Contents
WebHooksWhat is a Webhook?Taken directly from the official WebHook website: “The concept of a WebHook is simple. A WebHook is an HTTP callback: an HTTP POST that occurs when something happens; a simple event-notification via HTTP POST.” In other words, a WebHook is a method by which your application can react to events that occur during the Subscription Life cycle (e.g. a new subscription, a recurring payment is declined, a subscription is upgraded, etc.). For example, your blog or iPhone app can use WebHooks to grant customers access to special content, and restrict access to others. For more information, you can read more at the official webhook site. How it worksA WebHook URL is saved in your Merchant Settings. The URL points to a script in your app. We send a form POST message to your script when there is an event (e.g. a sign-up). Your script uses the information in the POST to trigger an action (e.g. enable content to a new user). A full list of events and sample scripts are available. WebHook URLThe WebHook URL, which is set in the Notification Settings area of the Merchant Center (separately for each store), defines the location of script on your Web site or App that contains code designed by you to interpret and react to the information provided by SubscriptionBridge in the post-back message. Here the steps required to configure your Webhook URL:
Webhook ScriptUnlike Post-backs, a Webhook POST can be received without any complex parsing. Since the Webhook is a form POST you can retrieve the values the same way you would with any other form on your web site. WebHook POST Fields
Testing WebHooksWe recommend that you use a site, such as PostCatcher, to collect the WebHooks. |
Contact us for more information, or head over to the free trial sign-up form to give SubscriptionBridge a try! Sign Up Free