Webhooks
Webhooks are an optional secure service provided by Judopay to use to notify your system when a transaction or event has taken place.
The benefit of using webhooks means you do not need to pull information from the Judopay API for every event.
You can use webhooks for:
Card payments:
Charge a card using a card’s full details:
16-digit card number
Expiry date
CV2
Pre-authorizations:
Reserve funds on a card.
Collections:
To collect the funds previously reserved with a pre-authorization.
Refunds:
Process a full or partial refund.
Enable Webhooks
From the Judopay Portal:
To enable webhooks:
![]() |
Step | Description |
---|---|
![]() | From the side menu, select Your apps Select the app you wish to edit. For the purpose of this exercise, Document Testing App is selected. |
![]() | Select Webhooks configuration |
![]() | Select the Webhooks for your required transaction type(s):
Add your Webhooks URL |
![]() | Click Save Webhooks |
![]() | The Add authentication section appears. Click Add authentication |
![]() | Confirm and click Add authentication |
![]() | Your unique username and password for authentication will be displayed. The username and password will be combined with a colon separating them and will be encoded using Base64. |
![]() | Click Save Webhooks The selected Webhooks will now be authenticated using this method.Judopay will send this username and password along with every request. |
Warning
Webhooks will not work until you add the authentication.