Item-Level Fields

Table 15

Item-Level Fields for RBS WorldPay Atlanta

CyberSource Field Name	RBS WorldPay Atlanta Field Name	Description	Used By: Required (R) or Optional (O)	Data Type & Length
item_#_alternateTaxID	Alternate Tax ID	Your tax ID number to use for the alternate tax amount. You must provide this value if you include Alternate Tax Amount in the request. Providing this value is optional if you do not Alternate Tax Amount. See Numbered Elements.	Level III ■ Mastercard (See description)	String (15)
item_#_commodityCode	Commodity Code	International description code used to classify the item. Contact your acquirer for a list of codes. See Numbered Elements.	Level III ■ Visa (R)	String (12)
item_#_discountAmount	Discount Amount	Discount applied to the item. See Numbered Elements.	Level III ■ Visa (O) ■ Mastercard (O)	Numeric (8)
item_#_discountRate	Discount Rate	Rate the item is discounted. See Numbered Elements. Example 5.25 (=5.25%)	Level III ■ Mastercard (O)	Numeric (5)
item_#_grossNetIndicator	Gross Net Indicator	Flag that indicates whether the tax amount is included in the Line Item Total. See Numbered Elements. Possible values: ■ Y: item amount includes tax amount ■ N: item amount does not include tax amount	Level III ■ Mastercard (R)	String (1)
item_#_invoiceNumber	No corresponding RBS WorldPay Atlanta field	Field to support an invoice number for a transaction.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 III ■ Visa (O) ■ Mastercard (O)	String (23)
item_#_productCode	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)	String (12)
item_#_productName	Description	Text description of the item. See Numbered Elements.	Level III ■ Visa (R) ■ Mastercard (R)	String (35)
item_#_quantity	Quantity	Number of units of the item purchased. This value must be a whole number. If you do not provide this value, CyberSource uses 1. See Numbered Elements.	Level III ■ Visa (R) ■ Mastercard (R)	Visa: Numeric (10) Mastercard: Numeric (8)
item_#_taxAmount	Tax Amount	Total tax to apply to the product. This value cannot be negative. If no tax is present, you can send in a value of 0. See Numbered Elements. The item_#_taxAmount field is additive. For example, if you send one item with unitPrice of 10.00 and taxAmount of 0.80, and you send another item with unitPrice of 20.00 and taxAmount of 1.60, the total amount authorized will be for 32.40, not 30.00 with 2.40 of tax included. The item_#_taxAmount and the item_#_unitPrice must be in the same currency.	Level II ■ Visa (R) ■ Mastercard (R)   Level III ■ Visa (R) ■ Mastercard (R)	Numeric (8)
item_#_taxRate	Tax Rate	Tax rate applied to the item. See Numbered Elements. Valid range is 0.0001 to 0.9999 (0.01% to 99.99%). The value can also be zero.	Level III ■ Mastercard (O)	Numeric (4)
item_#_taxTypeApplied	Tax Type	Type of tax being applied to the item. See Numbered Elements. Possible values: ■ 0000: unknown tax type ■ 0001: federal/national sales tax ■ 0002: state sales tax ■ 0003: city sales tax ■ 0004: local sales tax ■ 0005: municipal sales tax ■ 0006: other tax ■ 0010: value-added tax ■ 0011: goods and services tax ■ 0012: provincial sales tax ■ 0013: harmonized sales tax ■ 0014: Quebec sales tax (QST) ■ 0020: room tax ■ 0021: occupancy tax ■ 0022: energy tax ■ Blank: tax not supported on line item.	Level III ■ Mastercard (R)	String (4)
item_#_totalAmount	Line Total	Total purchase amount for the item. Normally calculated as the unit price x quantity. See Numbered Elements.	Level III ■ Visa (R) ■ Mastercard (R. Do not use all zeros or spaces.)	Numeric (8)
item_#_unitOfMeasure	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)	String (12)
item_#_unitPrice	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).	Level III ■ Visa (R) ■ Mastercard (R)	Visa: Numeric (10) Mastercard: Numeric (8)