When you create a checkout using the
Checkouts endpoint, Digital River automatically calculates the taxes due on items in the checkout using the following data points:
The specific SKUs in an order
The ship from address
The ship to address for physical products
The billing address for digital products
The purchase location address if neither the previous two addresses are supplied
Example: If you have a guest user on your Italian site and you want to present them with a tax calculation prior to their providing a ship to address include the
purchaseLocation parameter in your request.
Digital River determines the appropriate amount of taxes using the information provided and adds the tax amounts to the checkout in the response.
Digital River bases its tax calculation on the SKU
curl https://api.digitalriver.com/skus \-u sk_test_db9682a2-b04a-4e94-8e11-35fe8ec0b324: \-d id="5823594809" \-d name="Athena Womens Running Shoes" \-d eccn="9E003" \-d taxCode="531029.2" \-d manufacturerId="20013" \-d weight="20.5" \-d weightUnit="oz" \-d partNumber="SWG1224J10L"
Checkouts endpoint also supports tax exemption for business transactions. Set the tax identifier on the Digital River Customer object like this:
curl https://api.digitalriver.com/customers/fd74a5c5-0163-469a-ae8e-031f0259b576 \-u sk_test_db9682a2-b04a-4e94-8e11-35fe8ec0b324: \-d taxIdentifiers[uk]="GB999 9999 73"
Create or update a
Checkout with the customer identifier, and Digital River will use the tax identifier to calculate the appropriate tax amount.
You can add one or more tax identifiers to a customer. Digital River will automatically validate some tax identifier types (see table below), and, if verified, will reverse any tax charges.
The same tax identifiers shall appear in the header of the customer tax invoice and credit memo PDFs.
Digital River supports the following tax identifier types:
Cadastro Nacional da Pessoa Jurídica
Cadastro de Pessoas Físicas (individuals)
Codice Fiscal (individuals)
VAT Number (individuals)
Consumption Tax ID (offshore)
VAT Number (offshore)
Unified Business Number
Unified Business Number (offshore)
United Arab Emirates