Simple Order API

item_#_alternateTaxRate

Alternative tax rate applied to the item.
FDC Nashville Global
For Mastercard, this is the rate for a special tax.
For Visa, this is a VAT tax or other tax rate.
OmniPay Direct
This rate is used to generate the value of the
item_#_alternateTaxAmount
Item-level
field.
When you include the
item_#_alternateTaxAmount
Item-level
field or the
otherTax_nationalTaxAmount
request field, do not include the
item_#_alternateTaxRate
field. The
otherTax_nationalTaxAmount
request field rate will be set using the following equation:
otherTax_nationalTaxAmount
/
item_#_unitPrice
field.
For Visa, this is a VAT tax or other tax rate.

Specifications

  • Data Type:
    String
  • Data Length:
    • OmniPay Direct
      :
      4
    • Worldpay VAP
      :
      8
    • All other processors:
      5

Mapping Information

  • REST API Field:
    orderInformation.lineItems[].taxDetails[].rate
  • SCMP API Fields:
    • alternate_tax_amount
    • vat_rate
  • Simple Order API Fields:
    • item_#_alternateTaxRate
    • item_#_vatRate

Processor Field Names

This list provides the Level II/Level III processor field name for each processor that supports Level II or Level III data:
  • FDC Nashville Global
    : Item Tax Rate Applied
  • FDMS South
    : Does not apply
  • GPN
    : Tax Rate N
  • OmniPay Direct
    : VAT / TAx Rate (Freight or Shipping)
  • Worldpay VAP
    : taxRate