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 Simple Order API
    - Optional Fields for a Tax Calculation Using the SO API
    - Example: Processing a Tax Calculation Using the SO 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 Simple Order API
    - Optional Fields for an International Tax and VAT Calculation Using the Simple Order API
    - Example: Processing an International Tax Calculation Using the SO 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 SO API
    - Optional Fields for a Committed Tax Request Using the SO API
    - Example: Processing a Committed Tax Request Using the SO API
  - International Tax and VAT Committed Tax Calculation
    - Required Fields for an International Tax and VAT Committed Tax Calculation Using the SO API
    - Optional Fields for an International Tax and VAT Committed Tax Calculation Using the SO API
    - Example: Processing an International Tax and VAT Committed Tax Calculation Using the SO 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 SO API
  - Example: Processing a Tax Refund Calculation Using the SO API
- Void Tax Calculation
  - Required Field for a Tax Void Using the SO API
  - Example: Processing a Tax Void Using the SO API

Supported Countries and Regions

City Abbreviations

When to Calculate Taxes

You can calculate tax at these times during the order process:

When the customer prompts for a subtotal or total.

When the customer performs a final check out.

When the order ships, which ensures that the current tax rate is applied to the order.

As you determine how and where to implement the Tax Calculation Service on your website, consider that the Global Tax Calculation Service is billable for each request. To offset your costs and optimize your pricing, consider waiting to request a tax calculation until after your customer has entered their shipping or billing address on the checkout page. This minimizes the number of tax calculation requests for a single transaction. To ensure that your business complies with tax laws, work with a tax advisor to determine when to calculate tax.

For more information on when to calculate US and Canadian taxes, see Step 4: When to Calculate Tax.