On This Page
Webhook Health Check URL and Automatic Revalidation
When you create a webhook subscription,
Visa Acceptance Solutions
recommends that you include
a health check URL in the request. Including a health check URL enables Visa Acceptance Solutions
to monitor your server's status for reliability. When Visa Acceptance Solutions
detects that your health check URL is unresponsive, notification
deliveries are withheld until your health check URL becomes responsive again. A health
check URL ensures that you do not miss any notifications.To add a health check URL to your
create a subscription
request, include the healthCheckurl
field and set it to your health check URL.
You must also include the deactivateflag
field and
set it to true
to enable Visa Acceptance Solutions
to withhold
notifications for periods when your server becomes unresponsive.Automatic Activation
After you successfully create or update a subscription,
Visa Acceptance Solutions
pings your
health check URL within 5—10 minutes. If Visa Acceptance Solutions
receives a
response, the subscription status automatically becomes ACTIVE
and
notifications are delivered. When Visa Acceptance Solutions
does not receive a
response, your subscription status remains SUSPENDED
until Visa Acceptance Solutions
receives a response. If you did not include a health check
URL when you created the subscription, Visa Acceptance Solutions
pings your
webhook URL for automatic activation instead. You can also activate a subscription
that is not automatically activated by sending a PUT request. For more information,
see Activate a Webhook Subscription.Figure:
Webhook Automatic Activation
Automatic Revalidation
After the subscription's initial activation,
Visa Acceptance Solutions
continues to monitor
your server status. If Visa Acceptance Solutions
detects that your server is
unavailable, your subscription status automatically updates to
SUSPENDED
, and notifications are withheld. When Visa Acceptance Solutions
detects that your server is available again, your
subscription status automatically updates to ACTIVE
, and all
withheld notifications are delivered.