Stripe Webhooks

A webhook is a URL that Stripe uses to send messages to Payage. They are used to confirm transactions, and to notify Payage about refunds and other status updates. Payage automatically creates a webhook in your Stripe account when you publish a Stripe account in Payage, and removes it when you unpublish or delete the account. Normally, no manual configuration is required. Webhook URL's typically look something like this:

https://www.mysite.com/index.php/?option=com_payage&task=webhook_nc&tid=0&aid=1009

The URL should always route to the correct gateway addon in Payage, with the correct gateway account ID. Issues can arise if the webhook(s) in your Stripe account no longer match your Payage gateway account, and sometimes due to other site configuration changes.

If you receive emails from Stripe saying, "We've had some trouble sending requests to a webhook endpoint", you need to take action. What that message really means is that Stripe sent a request to the webhook URL, but did not receive an HTTP status 200 (OK) response. That could be because the routing failed for some reason, or because the Payage account no longer exists.

To resolve this problem, login to your Stripe account, go to Developers, Webhooks, and check the webhooks. If you see one that does not correspond to an account in Payage, click on it and delete it. If you are not sure why the problem is occurring, delete all the webhooks in your Stripe account, then go to Payage and unpublish and re-publish your Stripe gateway account(s). Payage will re-create the correct webhook(s).