Tax & Pricing Modes

Pricing Modes

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

Example

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

Setting the Pricing Mode

Note: pricingMode is only available for server-to-server payments (POST /api/server/payment). Payment links use the boolean isVatIncluded field instead (false = tax-exclusive, true = tax-inclusive). For subscription offers, the tax-inclusive setting is configured from the Dashboard when creating the offer. Hosted checkout payments (POST /api/checkout/payment) always use TAX_EXCLUSIVE.

On Server-to-Server Payment Creation

curl -X POST https://api.inflowpay.xyz/api/server/payment \
  -H "X-Inflow-Api-Key: inflow_prod_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 Payment Link Creation

Payment links use isVatIncluded (boolean) instead of pricingMode:

curl -X POST https://api.inflowpay.xyz/api/link \
  -H "X-Inflow-Api-Key: inflow_prod_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{ "name": "Product", "price": 10000, "quantity": 1 }],
    "currency": "EUR",
    "isVatIncluded": true
  }'

If pricingMode / isVatIncluded is not specified, prices are treated as tax-exclusive 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 and amount before creating a payment:

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

Response:

{
  "amountWithTaxInCents": 12000,
  "taxAmountInCents": 2000,
  "taxRateInPercentage": 20,
  "taxablePartInPercentage": 100,
  "countryCode": "FR",
  "postalCode": null,
  "purchasingAsBusiness": false
}

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_prod_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",
  "amountInCents": 10000,
  "amountTaxesIncluded": 12000,
  "taxCountry": "FR",
  "taxRateInPercentage": 20,
  "status": "PAYMENT_SUCCESS"
}

Quaderno Integration

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