Order-Level Fields

 

Table 10

Order-Level Fields for FDMS South

CyberSource Field Name	Description	Used By: Required (R) or Optional (O)	Data Type & Length
invoiceHeader_purchaserCode	Customer ID reference number that identifies the customer for a Level II transaction.	Level II ■ Visa (R for purchase/procurement cards; otherwise O)	String (17)
invoiceHeader_purchaserVATRegistrationNumber	Identification number assigned to the purchasing company by the tax authorities.	Level II ■ Visa	String (13)
invoiceHeader_summaryCommodityCode	Categorizes purchases for VAT reporting.	Level II ■ Visa	String (4)
invoiceHeader_taxable	Flag that indicates whether an order is taxable. Possible values: ■ true: the order is taxable. ■ false: the order is not taxable.	Level II ■ Visa ■ Mastercard	String (5)
invoiceHeader_userPO	Value used by your customer to identify the order. This value is typically a purchase order number. CyberSource recommends that you do not populate the field with all zeros or nines.	Level II ■ Visa (R for purchase/procurement cards; otherwise O) ■ Mastercard (R for purchase/procurement cards; otherwise O)	String (25)
purchaseTotals_dutyAmount	Total charges for any import or export duties included in the order. This value cannot be negative.	Level II ■ Mastercard	String (15)
shipFrom_postalCode	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 ■ Mastercard	String (10)
shipTo_country	Country of the shipping address. Use the two-character ISO Standard Country Codes.	Level II ■ Mastercard	String (2)
shipTo_postalCode	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   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 ■ Mastercard (R for purchase/procurement cards; otherwise O)	String (10)