Item-Level Fields

Table 7

Item-Level Fields for FDC Nashville Global

CyberSource Field Name	FDC Nashville Global Field Name	Description	Used By: Required (R) or Optional (O)	Data Type & Length
item_#_alternateTaxAmount	Item Other Tax Amount	See Numbered Elements. Visa: VAT or other tax amount Mastercard: Tax amount collected for a special type of tax Important For Mastercard, do not set this field to 0 (zero).	Level III ■ Visa (O) ■ Mastercard (O)	String (13)
item_#_alternateTaxID	Tax Amount 1 Tax ID	Your tax ID number to use for the alternate tax amount. See Numbered Elements.	Level III ■ Mastercard (R if item_#_ alternateTax Amount is included; otherwise O)	String (15)
item_#_alternateTaxRate	Item Tax Rate Applied	See Numbered Elements. Mastercard: Tax rate for a type of tax collected. Visa: VAT or other tax rate.	Level III ■ Visa (O) ■ Mastercard (O)	String (5)
item_#_alternateTaxType	Tax Type Identifier	Flag that indicates the type of tax collected for item_#_alternateTaxAmount. See Numbered Elements. Possible values: ■ 00: unknown ■ 01: federal or national sales tax ■ 02: states sales tax ■ 03: city sales tax ■ 04: local sales tax ■ 05: municipal sales tax ■ 06: other tax ■ 10: value-added tax (VAT) ■ 11: goods and services tax (GST) ■ 12: provincial sales tax ■ 20: room tax ■ 21: occupancy tax ■ 22: energy tax	Level III ■ Visa (O) ■ Mastercard (O)	String (2)
item_#_alternateTaxTypeApplied	Item Tax Type Applied	See Numbered Elements. Mastercard: Flag that defines tax categories for domestic processing in certain locations. Visa: VAT or other tax type.	Level III ■ Visa (O) ■ Mastercard (O)	String (4)
item_#_commodityCode	Item Commodity Code	International description code used to classify the item. Contact your acquirer or FDC Nashville Global for a list of codes. See Numbered Elements.	Level III ■ Visa (R) ■ Mastercard (O)	String (12)
item_#_discountAmount	Item Discount Amount	Discount applied to the item. See Numbered Elements. Important For Mastercard, do not set this field to 0 (zero).	Level III ■ Visa (O) ■ Mastercard (O)	String (13)
item_#_invoiceNumber	No corresponding FDC Nashville Global field	You must specify the number of line items that will include an invoice number. By default, the first line item will include an invoice number field. The invoice number field can be included for up to 10 line items. See Numbered Elements.	Level II ■ Visa (See description) ■ Mastercard (See description) ■ American Express (See description)   Level III ■ Visa (See description) ■ Mastercard (See description)	String (23)
item_#_localTax	Item Local Tax Amount	Sales tax applied to the item. See Numbered Elements. Important For Mastercard, do not set this field to 0 (zero).	Level III ■ Visa (O) ■ Mastercard (O)	String (13)
item_#_nationalTax	National Tax Amount	Amount of national tax or value added tax for countries in which more than one tax is applied. Provide this value if national_tax differs from tax_amount. If you do not provide this value, CyberSource assumes that national_tax is equal to tax_amount. See Numbered Elements. Important For Mastercard, do not set this field to 0 (zero).	Level II ■ Visa (R for non-U.S. Visa transactions; otherwise, not used)	String (11)
item_#_productCode	Item Product Code	Type of product. This value is used to determine the category that the product is in: electronic, handling, physical, service, or shipping. The default value is default. See Product Codes for a list of valid values. See Numbered Elements. For ccAuthService, when you set this field to a value other than default or any of the values related to shipping or handling, the item_#_quantity, item_#_productName, and item_#_productSKU fields are required.	Level III ■ Visa (R) ■ Mastercard (R for reduced interchange)	String (12)
item_#_productName	Description	Text description of the item. See Numbered Elements.	Level III ■ Visa (R for Level III interchange) ■ Mastercard (R for Level III interchange. Do not use all zeros or spaces.)	Visa: String (26) Mastercard: String (35)
item_#_productSKU	Item Customer Code	Identification code for the product. For ccAuthService and ccCaptureService, this field is required when item_#_productCode is not default or one of the values related to shipping or handling. See Numbered Elements.	Level III ■ Visa (See description) ■ Mastercard (See description)	String (30)
item_#_quantity	Item Quantity	Number of units of the item purchased. Must be a whole number. If you do not provide this value, CyberSource uses 1. See Numbered Elements.	Level III ■ Visa (R) ■ Mastercard (RS for reduced interchange)	Integer (12)
item_#_taxAmount	Local Tax Amount	Total tax to apply to the product. This value cannot be negative. The tax amount and the unit price must be in the same currency. The tax amount field is additive. The following example uses a two-exponent currency such as USD: 1 You include the following items in your request: item_0_unitPrice=10.00 item_0_quantity=1 item_0_taxAmount=0.80 item_1_unitPrice=20.00 item_1_quantity=1 item_1_taxAmount=1.60 2 The total amount authorized will be 32.40, not 30.00 with 2.40 of tax included. See Numbered Elements. Note This value is the sales tax. For Visa transactions, this value must be between 0.1% and 22% of the total sale. Note For Visa and American Express, if this value is 0 (zero), the order is tax exempt. Important For Mastercard, do not set this field to 0 (zero).	Level II ■ Visa (R) ■ Mastercard (R) ■ American Express (R)	Visa & Mastercard:String (11) American Express: String (9)
item_#_unitOfMeasure	Item Bulk/Unit of Measure	Unit of measure, or unit of measure code, for the item. See Codes for Units of Measurement See Numbered Elements.	Level III ■ Visa (R) ■ Mastercard (R for reduced interchange)	String (12)
item_#_unitPrice	Item Unit Cost	Per-item price of the product. This value cannot be negative. You can include a decimal point (.), but you cannot include any other special characters. CyberSource truncates the amount to the correct number of decimal places. See Numbered Elements. Important For a Level III transaction, this value cannot be zero (0). Important For Mastercard, do not set this field to 0 (zero).	Level II ■ Visa (R) ■ Mastercard (R) ■ American Express (R)   Level III ■ Visa (R) ■ Mastercard (R)	String (13)