Subscriptions are recurring payments that recur at regular intervals. For example, the monthly fee for a subscription service.

In the case of subscriptions, define plans with Stripe and reference them in your configuration. PayPal recurring payments can use Stripe plan data to launch as well.

PayPal integration requires that the Instant Payment Notification (IPN) endpoint is configured as usual. Stripe webhooks are set up directly by Vertex, so there is no additional action necessary.

With both Stripe and PayPal, it is possible to tax the same amount for the subscription and add tax to the price based on the customer’s assigned VAT rate.

For Stripe subscriptions, the total amount (base amount + tax) can increase or decrease when the tax rate changes.

For PayPal subscriptions, the total amount remains the same, but adjusts for the tax amount calculated.

UI-based Integrations (Pre-defined products)

The simplest way to launch the Checkout Form, so each product has a unique checkout link, is to declare product definitions in the Merchant Portal and then copy-and-paste links or HTML code that is used to launch the form.

Example product link:



Only the Taxamo.Checkout(), Taxamo.Product() and Taxamo.CheckoutJWT() functions can be used. The Taxamo.doSubscriptionCheckout and Taxamo.performCheckout functions should not be used.


The Checkout Form can also be launched with the Taxamo.js file. This method is more appropriate when you have a larger mix of products and your customers checkout with a basket of products.

In case of a subscription between Vertex and the customer, for example a delegated sale, the transaction key returned will belong to Vertex's transaction. It can be easily fetched using the API.

Try it here (the JavaScript code below can be modified to your liking):