Webhooks

Webhooks are a mechanism that allows external applications, like the payment connectors, to be notified about events happening inside Cleeng.

Cleeng is working with industry-leading payments providers Adyen and PayPal to provide merchant services to our clients. In order for you to start processing the payments, you need to have the two major configurations completed

Step 1: Enable Payment Service Provider (PSP)

Before you start configuring the webhooks, you need to enable the Payment Service Provider (PSP) (whether it's Adyen/PayPal or both) for your integration. To do so, you can contact our BSS team to enable it for you. Simply, send an email to BSS or use this form with category Payment Integration/API.
You can find more about setup in Payment with Adyen and Payment with PayPal Express Checkout

Note: If you prefer to use Adyen payment gateway, we need the list of origins for your domain. Send us a list of origins where you want to use them, so we will add them to the whitelist for Adyen clientKey.

Step 2: Configure Webhooks

Subscribing to the webhooks and filtering setup (required for recurring).

Connectors reacting to webhooksConnectors reacting to webhooks

Connectors reacting to webhooks

Configure them with Webhook settings (please pay attention to the tables below). Remember to take into account any connectors you use.

No matter what connector you choose, we recommend that you apply the webhook filtering logic to differentiate transactions coming from the respective connectors for reporting purposes.

You can read more about webhooks and Webhooks filtering

Here are tables with Cleeng connectors production endpoints which will be needed if you are using Cleeng connectors (Adyen, PayPal):

Webhook topic

Adyen endpoint

subscriptionReadyForPaymentAuthorisation

https://adyenapi.cleeng.com/adyen/recurring/authorisations

subscriptionReadyForPaymentCapture

https://adyenapi.cleeng.com/adyen/recurring/captures

subscriptionReadyForTermination

https://adyenapi.cleeng.com/adyen/recurring/terminations

Webhook topic

Paypal endpoint

subscriptionReadyForPaymentAuthorisation

https://connector.cleeng.com/paypal/v1/payments/authorize

subscriptionReadyForPaymentCapture

https://connector.cleeng.com/paypal/v1/payments/capture

subscriptionReadyForTermination

https://connector.cleeng.com/paypal/v1/subscriptions/terminate

Here are tables with Cleeng connectors test endpoints which will be needed if you are using Cleeng connectors (Adyen, PayPal):

Webhook topic

Adyen endpoint

subscriptionReadyForPaymentAuthorisation

https://adyenapi-sandbox.cleeng.com/adyen/recurring/authorisations

subscriptionReadyForPaymentCapture

https://adyenapi-sandbox.cleeng.com/adyen/recurring/captures

subscriptionReadyForTermination

https://adyenapi-sandbox.cleeng.com/adyen/recurring/terminations

Webhook topic

Paypal endpoint

subscriptionReadyForPaymentAuthorisation

https://connector-sandbox.cleeng.com/paypal/v1/payments/authorize

subscriptionReadyForPaymentCapture

https://connector-sandbox.cleeng.com/paypal/v1/payments/capture

subscriptionReadyForTermination

https://connector-sandbox.cleeng.com/paypal/v1/subscriptions/terminate

Up Next

Now that we have configured the webhooks for recurring billing, let's look into dunning action settings.

Dunning action settings


Did this page help you?