Order-Level Fields

Table 6

Order-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
ccCaptureService_purchasingLevel	No corresponding FDC Nashville Global field	Flag that indicates the capture request includes Level III data. Set the value for this field to 3. For more information, see Requesting Captures and Credits with Level III Data.	Level III ■ Visa (R for captures; not used for credits) ■ Mastercard (R for captures; not used for credits)	String (1)
ccCreditService_purchasingLevel	No corresponding FDC Nashville Global field	Flag that indicates the credit request includes Level III data. Set the value for this field to 3. For more information, see Requesting Captures and Credits with Level III Data.	Level III ■ Visa (R for credits; not used for captures) ■ Mastercard (R for credits; not used for captures)	String (1)
invoiceHeader_purchaserVATRegistrationNumber	Customer VAT Registration Number	Identification number assigned to the purchasing company by the tax authorities.	Level II ■ Visa (R for non-U.S. Visa transactions; otherwise, not used)	String (13)
invoiceHeader_supplierOrderReference	Item Description Part A	Text description of the item. Important Starting May 1, 2012: Due to the limited functionality of the invoiceHeader_supplierOrder Reference field, CyberSource recommends that you use the item-level field item_#_productName instead. Include only one of these fields in a request; including both fields could result in an error.	Level III ■ Visa (R) ■ Mastercard (R for reduced interchange)	String (25)
invoiceHeader_userPO	Customer Code	Value used by your customer to identify the order. This value is typically a purchase order number. You must provide a value in this field or in the merchantReferenceCode field. CyberSource recommends that you do not populate this field with all zeros or nines.	Level II ■ Visa (See description) ■ Mastercard (See description) ■ American Express (See description)   Level III ■ Visa (See description) ■ Mastercard (See description)	String (25)
invoiceHeader_vatInvoiceReferenceNumber	VAT Invoice Reference Number	VAT invoice number associated with the transaction.	Level II ■ Visa (R for non-U.S. Visa transactions; otherwise, not used)	String (15)
otherTax_alternateTaxAmount	Other Tax Amount	Amount of all taxes, excluding the local tax (item_#_taxAmount) and national tax (item_#_nationalTax) included in the total tax.	Level II ■ Visa (R for non-U.S. transactions; otherwise, not used) ■ Mastercard (R for non-U.S. transactions; otherwise, not used) ■ American Express (R for non-U.S. transactions; otherwise, not used)   Level III ■ Visa (O for non-U.S. transactions; otherwise, not used) ■ Mastercard (O for non-U.S. transactions; otherwise, not used)	String (11)
otherTax_alternateTaxIndicator	Other Tax Indicator	Flag that indicates whether the alternate tax amount (otherTax_alternateTaxAmount) is included in the request. Possible values: ■ 0: alternate tax amount is not included in the request. ■ 1: alternate tax amount is included in the request.	Level II ■ Mastercard (R for non-U.S. transactions; otherwise, not used)   Level III ■ Mastercard (O for non-U.S. transactions; otherwise, not used)	String (1)
otherTax_vatTaxAmount	VAT/Tax Amount	Total amount of VAT or other tax on freight or shipping only.	Level II ■ Visa (O for non-U.S. transactions; otherwise, not used) ■ Mastercard (O for non-U.S. transactions; otherwise, not used) ■ American Express (O for non-U.S. transactions; otherwise, not used)	String (11)
otherTax_vatTaxRate	VAT/Tax Rate	Vat tax rate for freight or shipping.	Level II ■ Visa (O for non-U.S. transactions; otherwise, not used) ■ Mastercard (O for non-U.S. transactions; otherwise, not used) ■ American Express (O for non-U.S. transactions; otherwise, not used)	String (5)
purchaseTotals_discountAmount	Discount Amount	Total discount applied to the order. This value cannot be negative. For example: a 20.00 discount off the order total.	Level II ■ Visa (R) ■ Mastercard (O)   Level III ■ Visa (O)	String (11)
purchaseTotals_dutyAmount	Duty Amount	Total charges for any import or export duties included in the order. This value cannot be negative.	Level II ■ Visa (R) ■ Mastercard (O)   Level III ■ Visa (O)	String (11)
purchaseTotals_freightAmount	Freight Amount	Total freight or shipping and handling charges for the order. When you include this field in your request, you must also include purchaseTotals_grandTotalAmount.	Level III ■ Visa (O) ■ Mastercard (O)	String (13)
purchaseTotals_grandTotalAmount	No corresponding FDC Nashville Global field	Grand total for the entire capture or credit request.	Level III ■ Visa (R) ■ Mastercard (R)	String (15)
shipFrom_postalCode	Ship From Zip	Postal code for the address from which the goods are shipped, which is used to determine nexus. The default is the postal code associated with your CyberSource account. The postal code must consist of 5 to 9 digits. If the billing country is the U.S., the 9-digit postal code must follow this format: [5 digits][dash][4 digits] Example 12345-6789 If the billing country is Canada, the 6-digit postal code must follow this format: [alpha][numeric][alpha] [space][numeric][alpha] [numeric] Example A1B 2C4	Level II ■ Visa (O) ■ Mastercard (O)   Level III ■ Visa (R) ■ Mastercard (R)	String (10)
shipTo_country	Destination Country	Country of the shipping address. Use the two-character ISO Standard Country Codes.   Note If you include the shipTo_country field in a request and if the ship-to country is the U.S. or Canada, the request must also include the shipTo_state field.	Level II ■ Mastercard (R)   Level III ■ Visa (R if purchase Totals_freight Amount is included; otherwise, recommended for best rate) ■ Mastercard (O but recommended)	String (2)
shipTo_postalCode	Destination Zip	Postal code for the shipping address. The postal code must consist of 5 to 9 digits. When the shipping country is the U.S., the 9-digit postal code must follow this format: [5 digits][dash][4 digits] Example 12345-6789 When the shipping country is Canada, the 6-digit postal code must follow this format: [alpha][numeric][alpha][space] [numeric][alpha][numeric] Example A1B 2C3   This value is the same as the value for shipFrom_postalCode when your customer takes possession of the items at your location. If the postal code for the shipping address is not included in the request message, CyberSource uses the postal code for the billing address. If the postal code for the billing address is not included in the request message, the postal code for the shipping address is required.	Level II ■ Visa (R) ■ Mastercard (R) ■ American Express (R)   Level III ■ Visa (R) ■ Mastercard (R)	String (10)
shipTo_state		State or province of the shipping address. Use the State, Province, and Territory Codes for the United States and Canada.   This field must be included in a request if the shipTo_country field is included and the ship-to country is the U.S. or Canada.	Level II ■ Mastercard (R)   Level III ■ Visa (See description) ■ Mastercard (See description)	String (2)