We currently use cookies to improve and customize your experience on our site. If you accept, we’ll also use marketing cookies to show you personalized ads. Manage your cookies and learn more.
tax_list
Taxes applied to this item. Tax is displayed separately to customers during checkout.
An array of tax objects.
namestringOptional
Internal label for this tax (e.g., "Sales Tax", "VAT"). Not visible to customer.
Match^.*$Length1 <= length <= 127
typeenumRequired
The method used to calculate this tax.
Match^[A-Z0-9_]+$Length1 <= length <= 32
Allowed values
"PERCENTAGE"
Applies a flat percentage to the item amount (e.g., 10% sales tax).
"PREFERENCE"
Calculates tax based on the merchant's PayPal account tax settings. Requires merchant to have tax rates configured in their PayPal account Settings.
valuestringRequired
The tax amount or reference. For PERCENTAGE, enter the numeric percentage value (e.g., "10" for 10%). For PREFERENCE, must be set to "PROFILE". Maximum 20 characters.