Judopay Documentation

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:

webhooks

Step

Description

One.png

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.

Two.png

Select Webhooks configuration

Three.png

Select the Webhooks for your required transaction type(s):

  • Enable Webhooks Payment

  • Enable Webhooks Collection

  • Enable Webhooks PreAuth

  • Enable Webhooks Refund

Add your Webhooks URL

Four.png

Click Save Webhooks

Five.png

The Add authentication section appears.

Click Add authentication

Six.png

Confirm and click Add authentication

Seven.png

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.

Eight.png

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.