API Overview

Tax Calculation Developer Guide
- Recent Revisions to This Document
- VISA Platform Connect: Specifications and Conditions for Resellers/Partners

Overview of Tax Calculation
- Prerequisites for Tax Calculation
  - Tax Nexus
  - Product Codes
  - Address Requirements
  - When to Calculate Taxes

Tax Calculation
- US and Canadian Tax Calculation
  - Calculating US and Canadian Tax
    - Required Fields for a Tax Calculation Using the REST API
    - Optional Fields for a Tax Calculation Using the REST API
    - Example: Processing a Tax Calculation Using the REST API
- International Taxes and Value-Added Tax (VAT) Calculation
  - Calculating International Tax and VAT
    - Required Fields for an International Tax and VAT Calculation Using the REST API
    - Optional Fields for an International Tax and VAT Calculation Using the REST API
    - Example: Processing an International Tax Calculation Using the REST API

Tax Reporting
- Commit Tax Calculation
  - Commit Tax Calculation Scenarios
    - Scenario 1: Pre-authorization
    - Scenario 2: Post-capture
    - Scenario 3: Partial Captures
  - US and Canada Tax Commit
    - Required Fields for a Committed Tax Request Using the REST API
    - Optional Fields for a Committed Tax Request Using the REST API
    - Example: Processing a Committed Tax Request Using the REST API
  - International Tax and VAT Committed Tax Calculation
    - Required Fields for an International Tax and VAT Committed Tax Calculation Using the REST API
    - Optional Fields for an International Tax and VAT Committed Tax Calculation Using the REST API
    - Example: Processing an International Tax and VAT Committed Tax Calculation Using the REST API
- Refund Tax Calculation
  - Refund Tax Calculation Scenarios
    - Scenario 1: Full or Partial Refund
    - Scenario 2: Stand-alone Credit
  - Required Fields for a Tax Refund Calculation Using the REST API
  - Example: Processing a Tax Refund Calculation Using the REST API
- Void Tax Calculation
  - Required Fields for a Tax Void Using the REST API
  - Example: Processing a Tax Void Using the REST API

Supported Countries and Regions

City Abbreviations

REST Reason Codes

On This Page

Calculating International Tax and VAT

Before calculating international tax, make sure that the country is on the list of Supported Countries and Regions.

IMPORTANT

One tax service request should not include more than 50 line items. When you send a request with more than 50 line items, the request could time out.

VAT Number

When you include the

merchantInformation.vatRegistrationNumber

or

orderInformation.lineItems.vatRegistrationNumber

field and VAT rules and rates are applicable, the service calculates a VAT tax, and the relevant tax amounts are returned in the response.

There are some countries where VAT registration is not required. More details are mentioned in Supported Countries and Regions.

Product Codes

If a product is subject to special tax considerations, provide the appropriate tax product code in the

orderInformation.lineItems.productCode

field in the request. To use a product code that is not listed in the available guides, contact customer support for information about how to proceed.

Tax Per Item

When the tax calculation service succeeds, the response includes a tax amount for each item and indicates whether the tax amount was calculated by the tax calculation service or provided by you.

Endpoint

POST https://api.cybersource.com/vas/v2/tax

Back to top