type
is used to calculate taxes, refer to the page on setting the customer type.2020-12-17
and earlier, use the legacy features described in this section to manage tax identifiers. If you're on versions 2021-02-23
and later, refer to the Tax identifiers page.type
and a value
. The enumerated types typically comprise a lowercase, two-letter country code. The value
is dependent on the format used in each country.POST/customers/{id}
request:type
. So, if you'd like to attach a new tax identifier and it has the same type
as a saved tax identifier, you must first delete the existing object.POST/customers/{id}
request and set the value
you'd like to replace to ""
.value
without white spaces.POST/customers/{id}
request with the original type
and an updated value
:taxAuthority
matches the state
of the transaction's shipping or billing address. If the purchase contains physical products, we compare taxAuthority
to shipTo.address.state
. For transactions that only contain digital goods, we compare taxAuthority
to billTo.address.state
.endDate
elapses, the exemption no longer applies.sellingEntity.id
or sellingEntity.name
to determine the appropriate address and then display that information to the customer:sellingEntity.id
sellingEntity.name
DR_INC-ENTITY
Digital River, Inc.
C5_INC-ENTITY
DR globalTech Inc.
POST/files
request to create a file in Digital River's system. In the request, make sure you set purpose
to tax_document_customer_upload
id
and use it when adding the tax certificate to the customer.POST/customers/{id}
. In the body of the request, use the taxCertificate
block to set the companyName
, taxAuthority
, startDate
, endDate
, and fileId
parameters.companyName
must indicate the name of the company or organization that has been granted the tax exemption.taxAuthority
corresponds to the issuing state. The value you assign should be formatted to conform to the USPS two-letter state and possession abbreviation standard. These are the same abbreviations used in the ISO 3166-2 subdivision codes.startDate
and endDate
values correspond to the issue and expiration dates of the tax certificate, respectively.startDate
and endDate
adhere to the date and time format used in the Digital River APIs.startDate
as the first date of the current month and endDate
as the last date of the current month. This allows us time to review the certificate, determine whether it's valid, and set the applicable dates.POST/customers
or POST/customers/{id}
request that you send can only contain one tax certificate.GET/customers/{id}
request and parse the response to verify the object has been successfully added to the taxCertificates
array.