Skip to main content
FunnelFox Payments Taxes charges tax on checkouts and renewals and reverses it on refunds. Use FunnelFox Tax to also get registered and have your returns filed, or enter your own rates.

How it works

FunnelFox Payments Taxes calculates tax at checkout and charges it together with the payment. Tax applies to first payments, renewals, one-click payments, and one-off charges. A free trial isn’t taxed, but the renewals after it are. A paid trial is taxed on the trial price. The immediate charge of a price_prorate migration isn’t taxed. Tax is reversed automatically when you refund an order, and a partial refund reverses its share. Tax is also reversed when an authorized payment is cancelled, voided, or expires. Chargebacks don’t reverse tax.

Providers

Each country uses one provider:
  • Tax Provider: FunnelFox Tax calculates the tax for the buyer’s location.
  • Static taxes: You enter the rates, and FunnelFox Payments applies them.
You can mix providers: FunnelFox Tax for one country, static rates for another. FunnelFox Tax tracks your sales, registers you in the countries and states you choose, and files your returns on each jurisdiction’s schedule. It charges tax only where you’re registered. You stay the taxpayer and pay the tax from your own bank account.

Tax behavior

Each country has a tax behavior:
  • Inclusive: Tax is part of the price, so the amount charged doesn’t change.
  • Exclusive: Tax is added on top of the price, so the amount charged depends on where the buyer is.
For a $20.00 monthly price point with a 20% tax rate: You can always see the tax on the payment’s page in your FunnelFox Payments dashboard. The tax appears under the amount and in the Tax field of Order details:

Customer address

Tax depends on the buyer’s location. By default, FunnelFox Payments reads it from the buyer’s IP. To calculate tax from the address the buyer enters, go to Taxes > Settings in your FunnelFox Payments dashboard and turn on Collect the customer’s location on the payment form.
Checkout then shows a country selector, plus a ZIP or postal code field where it changes the tax, such as in the US and Canada. Tax is recalculated as the buyer types. Apple Pay and Google Pay charge the tax calculated when the payment sheet opens. Renewals, one-click payments, and one-off charges use the location of the purchase they come from.
If you build your checkout with the FunnelFox Payments Web SDK, the checkout doesn’t show tax. The SDK reports the total and tax through onTaxChange so you can update your prices. Learn more about taxes in the Web SDK.In FunnelFox funnels, show tax with the Checkout’s price variables.

Setup

Configure Taxes from the Taxes section of your FunnelFox Payments dashboard.
1

Set up FunnelFox Tax

Skip this step if you use only static rates.Contact your Solutions Manager to set up FunnelFox Tax and choose the countries and states to register in. Then go to Taxes > Settings in your FunnelFox Payments dashboard to see FunnelFox Tax under the Tax Provider section.
2

Turn on tax for a country

Go to Taxes > Locations in your FunnelFox Payments dashboard and click Enable next to a country. Then:
  1. Select Tax Provider or Static taxes.
  2. Select the Tax behavior: Inclusive or Exclusive.
  3. Click Save.
If you select Static taxes and the country has no rate yet, its page opens so you can add one.
If saving fails with a message that FunnelFox Tax isn’t registered for the country, contact your Solutions Manager.
3

Add a tax rate

For Static taxes, add the country’s rate. For the US and Canada, you can also add a rate per state or province. For Tax Provider, a rate is optional and works as a fallback. Learn more in Tax rates.
4

Collect the customer's location (optional)

Go to Taxes > Settings in your FunnelFox Payments dashboard and turn on Collect the customer’s location on the payment form to calculate tax from the address the buyer enters. Learn more in Customer address.

Locations

The Taxes > Locations page in your FunnelFox Payments dashboard lists every country with transactions in the last 30 days, plus countries where tax is already on. Countries appear here automatically.
For each country, the page shows:
  • Gross volume (30d): The total charged in the last 30 days, tax included. Refunds aren’t deducted.
  • Transactions (30d): The number of transactions in the last 30 days.
  • Provider: Tax Provider or Static taxes, or empty when tax is off.
  • Behavior: Inclusive or Exclusive.
  • Status: One of:
    • Collecting: Tax is on for this country.
    • Needs attention: Tax is off, but you had transactions here in the last 30 days.
    • Not collecting: Tax is off, and you had no recent transactions here.
Click a country to change its provider and tax behavior. To turn tax off, set the provider to Not collecting. The country page also shows this month’s volume, transactions, and net tax. For the US and Canada, it lists each state or province. With static taxes, it flags those without a rate.

Historical transactions

When you turn on static tax for a country you already sell in, past transactions have no tax. They aren’t included in tax reports, and their months can’t be filed until you process them. To process them, open the country on the Taxes > Locations page and click Process historical transactions. The country must use static taxes with at least one rate, and this isn’t available for the US.
FunnelFox Payments calculates tax for past settled transactions with your current rates and tax behavior. Rate changes over time aren’t taken into account. The tax goes to your reports only and isn’t charged to customers. If more past transactions settle later, process again: transactions that already have tax aren’t processed twice.

Tax rates

The Taxes > Static rates page in your FunnelFox Payments dashboard holds your static rates. FunnelFox Payments uses them for countries set to Static taxes, and as a fallback for countries set to Tax Provider.
To add a rate, click Add rate and set:
  • Country: The country the rate applies to. One rate covers the whole country.
  • State or Province: For the US and Canada only. A state or province rate replaces the country rate there.
  • Rate (%): The tax rate, such as 20 for 20%.
  • Display name: An optional name for the tax, such as VAT.
Rates don’t add up. For a state or province with its own rate, enter the full rate, including any national tax. If a country has no rate, no tax is charged there. A rate change applies to new payments only.

Fallback rates

If FunnelFox Tax is unavailable, FunnelFox Payments charges the country’s static rate instead. Payments taxed with the fallback rate show a yellow warning icon next to the provider in the Provider column of Taxes > Transactions.
Without a static rate, charges in that country go through untaxed while FunnelFox Tax is unavailable.

Transactions

The Taxes > Transactions page in your FunnelFox Payments dashboard lists transactions with tax for the selected month, including the current one. For each transaction, the page shows:
  • Date: When the transaction was made.
  • Order: The order ID.
  • Jurisdiction: The country, plus the state or province and the ZIP or postal code when known.
  • Location source: How the buyer’s location was found: IP, Address, or ZIP entered.
  • Provider: Tax Provider or Static taxes. A yellow warning icon marks a fallback rate, and Backfilled marks tax added by historical processing.
  • Amount: The amount charged.
  • Tax: The tax amount, marked incl. for inclusive tax or excl. for exclusive tax.
  • Rate: The tax rate.
  • Status: One of:
    • Succeeded: The payment went through.
    • Refunded: The payment was fully or partially refunded.
    • Declined: The payment was declined.
Filter by month, country, and status. To download the month as a CSV, click Export CSV.

Reports

The Taxes > Reports page in your FunnelFox Payments dashboard has two reports:
  • Filing report: Totals per jurisdiction for a closed month, which is what you need to fill in a tax return. It covers static taxes only. For countries set to Tax Provider, filing reports are in a separate tax dashboard.
  • Reconciliation export: Transaction-level tax data as a CSV, including the current month.
Totals are per currency. Refunded tax is deducted in the month of the refund.
To create a filing report, select a closed month and a country, then click Generate report. To export transactions, click Export CSV. Turn on Include declined transactions to add declined payments to the file.
A month with untaxed past transactions can’t be filed. Process historical transactions for that country first.

Next steps