If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage 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.