GoCardlessDeveloper Docs
Create a sandbox account

Testing Webhooks (Dashboard)#

View as Markdown

Adding support for webhooks lets you receive real-time notifications from GoCardless when things happen in your account, so you can take automated actions in response.

When building your integration, you'll want to receive realistic webhooks to test how your code responds.

Developers header

You can trigger webhooks using scenario simulators, or with the Send test webhook tool on your Developers page in the dashboard.

Before using the Send test webhook tool, you need a webhook endpoint set up. Click Create → Webhook endpoints on the Developers page. If you've created apps, their endpoints will also be available.

Send test webhook button

Customise your webhook by selecting an endpoint and setting the resource type, action, cause, event details, and associated ID.

In your code, you'll typically use the ID to locate records in your database and take actions based on the webhook payload.

Click Send test webhook — it usually arrives within a few seconds. Refresh the page and the webhook will appear in your list.

Click on a webhook to inspect the full request and your response. This is useful for debugging.

Webhook detail view

Tip

You can resend any previously sent webhook by selecting it from the list and clicking Retry in the top-right corner.

What's next?#