At present, Paddle, Stripe, and FastSpring are the payment processors that we support. Each of these platforms includes a webhook feature that automatically sends notifications when an order is created and when a payment has been successfully completed.
The designated URL for receiving these webhook notifications is https://cloud.license4j.com/v5/integration. It’s important to note that you will need to set up the webhook in the settings of each payment processor’s website to ensure that the notifications are routed correctly.

Additionally, all payment processors utilize a specific range of IP addresses for sending webhooks. These IP addresses are clearly documented on the respective websites of Paddle, Stripe, and FastSpring. For security purposes, LICENSE4J relies on these predefined IP addresses to validate incoming webhook requests. This ensures that only legitimate notifications from the designated payment processors are processed, enhancing the overall security of your transactions.

When you are ready to integrate payments, click on "Actions" and then select "New menu item." Define the required fields and save your changes.

Please note that you will need to select a product and a template. If you have multiple products on your payment processor, you should only add one webhook destination on the payment processor's site. However, you must define integrations on LICENSE4J for each individual product. The selected template will be used to generate licenses with the specified properties from that template.

Paddle

If you are using Paddle, you need to define your product and pricing. After setting up product and price, go to the "Developer Tools" section on their website and select "Notifications" from the left menu. Click on the "New Destination" button in the top right corner. Then, enter the destination URL and select the "transaction.completed" event. In the "Developer Tools > Authentication" section, obtain your API key. This API key is necessary for defining an integration, as Paddle sends the "transaction.completed" event with a unique customer ID generated in their system. LICENSE4J will use the API key to retrieve user information (such as name and email) after the "transaction.completed" event occurs. Save this key on the settings page.

Stripe

To set up webhooks in Stripe, follow these steps:
1. Log in to your Stripe account.
2. Navigate to "Developers" in the bottom left corner of the page, and then select "Webhooks."
3. Click on "Add destination" in the top right corner of the page.
4. On the first page, select the event types "invoice.paid" and "checkout.session.completed."
5. On the second page, enter the URL you want to use.

Please note that LICENSE4J requires an API key for Stripe because, for one-time payments, Stripe does not send product and customer details by default. The API key is needed to extend the response and obtain this information. Save this key on the settings page.

Fastspring

To set up webhooks in Fastspring, log in to your account and navigate to the "Developers > Webhooks" menu on the left side. Then, click on the "Configuration" tab at the top and select the "Add URL Endpoint" button. Enter the URL and choose the event type "order.completed." Since Fastspring sends customer and product details in the webhook, LICENSE4J does not require an API key. See FastSpring integration document.