Taxamo

The Taxamo Developer Hub

Welcome to the Taxamo developer hub. You'll find comprehensive guides and documentation to help you start working with Taxamo as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    API Reference

Payment Providers

Currently, Taxamo supports two payment providers (with more pending):

  • Stripe for subscriptions and one-time payments.
  • PayPal for recurring and one-time payments.

Connecting a Stripe account

To enable Taxamo to collect payments and manage Stripe subscriptions, use the Taxamo Merchant Portal and connect a Stripe account in TEST and LIVE modes.

In the portal navigate to Settings > Manage Stripe Account (under ‘Payment Gateways) and press the Connect to Stripe button. The Stripe Connect mechanism will then guide you through the connection process.

Once the Stripe account is connected in LIVE mode, it might not be possible to change it without assistance from the Taxamo support team - please choose a correct account for LIVE mode. TEST mode accounts can be reconnected anytime through the Dashboard.

Connecting a PayPal account

To enable Taxamo to collect payments and manage PayPal recurring payments the following steps must be performed:

  1. Log-in to your PayPal account and navigate to Profile > My selling tools > API access > Update > View or Remove API Signature. Note down your account e-mail address, API username and signature

  2. Contact PayPal to enable Payouts on your account. You should then receive a notification from PayPal support to say ‘This feature is now enabled on your account’.

First-time users should contact their Account Manager or PayPal Customer Support to enable Payouts for their PayPal premier or business accounts. Confirm that they will support payouts for your home country and sales volume. It is possible to test the Payouts API in the PayPal Sandbox without prior authorization, but live PayPal accounts must be whitelisted.

  1. Log-in to the PayPal developer dashboard with your business credentials and create a REST API application with access to the Payouts API. To do so, click the Create app button under REST API apps within the My Apps & Credentials section. Keep this new app screen open as you will need the credentials shortly.

  2. Log-in to your Taxamo account and go Settings > PayPal. Enter the credentials from step 1 and step 3 into the fields provided under Connection status and click ‘Save settings’. Your credentials will then be verified against PayPal. If the credentials are verified you should now see a ‘Connected to PayPal in LIVE mode’ message in green. An IPN URL will also be presented.

  3. Finally, log-in to your PayPal business account and navigate to Profile > My selling tools > Instant payment notifications. Click update and enter the IPN URL from step 4 and save the settings. You should now be set up to create transactions.

Note: For recurring payments, the timezone must be provided and must match your PayPal timezone configuration.

You are now ready to create live transactions (single payment or subscriptions) depending on your business model. You will now need to check whether you are receiving payments in your merchant account. You should also see the payout to Taxamo.

Once the PayPal account is connected in LIVE mode, it might not be possible to change it without assistance from the Taxamo support team. TEST mode accounts can be reconnected anytime through the Dashboard.

Payment Providers


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.