Tax & Pricing Modes

Pricing Modes

Inflow supports two pricing modes that determine how tax is applied:

Mode	Description
`TAX_EXCLUSIVE` (default)	Product prices are excluding tax. Tax is calculated and added on top. The customer pays price + tax
`TAX_INCLUSIVE`	Product prices include tax. The displayed price is the total the customer pays. Tax is extracted from the price

Example

For a product priced at €100 with 20% VAT:

Mode	Product Price	Tax	Total Charged
TAX_EXCLUSIVE	€100	€20	€120
TAX_INCLUSIVE	€100	€16.67 (included)	€100

Setting the Pricing Mode

On Payment Creation (API)

curl -X POST https://api.inflowpay.xyz/api/server/payment \
  -H "X-Inflow-Api-Key: inflow_priv_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{ "name": "Product", "price": 10000, "quantity": 1 }],
    "currency": "EUR",
    "customerEmail": "[email protected]",
    "billingCountry": "FR",
    "purchasingAsBusiness": false,
    "pricingMode": "TAX_INCLUSIVE"
  }'

On Subscription Offer Creation

curl -X POST https://api.inflowpay.xyz/subscription/offer \
  -H "X-Inflow-Api-Key: inflow_priv_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pro Plan",
    "description": "Monthly access",
    "amountInCents": 2999,
    "currency": "EUR",
    "interval": "month",
    "intervalCount": 1,
    "pricingMode": "TAX_EXCLUSIVE"
  }'

If pricingMode is not specified, TAX_EXCLUSIVE is used by default.

Automatic VAT Calculation

Inflow automatically calculates the applicable VAT rate based on the customer's billing country. The VAT rate is determined when the payment is created using the billingCountry field.

Tax Rate API

You can query the tax rate for a specific country before creating a payment:

curl "https://api.inflowpay.xyz/api/tax/rate?country=FR&postalCode=75001" \
  -H "X-Inflow-Api-Key: inflow_priv_your_key"

This returns the applicable tax rate for the given country.

B2B Reverse Charge

For business-to-business (B2B) transactions within the EU, VAT reverse charge rules may apply:

Set purchasingAsBusiness: true when creating the payment.
Provide the customer's businessName and taxId (VAT number).
Inflow applies the appropriate B2B tax rules based on the customer's country and your merchant country.

curl -X POST https://api.inflowpay.xyz/api/server/payment \
  -H "X-Inflow-Api-Key: inflow_priv_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{ "name": "Service", "price": 50000, "quantity": 1 }],
    "currency": "EUR",
    "customerEmail": "[email protected]",
    "billingCountry": "DE",
    "purchasingAsBusiness": true,
    "businessName": "Acme GmbH",
    "taxId": "DE123456789",
    "pricingMode": "TAX_EXCLUSIVE"
  }'

Tax in Payment Responses

Tax information is included in payment responses:

{
  "id": "pay_abc123",
  "amount": 10000,
  "amountTaxesIncluded": 12000,
  "taxCountry": "FR",
  "taxRateInPercentage": 20,
  "pricingMode": "TAX_EXCLUSIVE",
  "status": "PAYMENT_SUCCESS"
}

Field	Description
`amount`	Base amount (excluding tax if TAX_EXCLUSIVE)
`amountTaxesIncluded`	Total amount including tax
`taxCountry`	Country used for tax calculation
`taxRateInPercentage`	Applied tax rate (e.g., 20 for 20%)
`pricingMode`	Pricing mode used

Quaderno Integration

For advanced tax compliance (automated tax receipts, filings, etc.), Inflow integrates with Quaderno. See Quaderno Integration for setup instructions.