Order-Level Fields

Table 12

Order-Level Fields for GPN

CyberSource Field Name	GPN Field Name	Description	Used By: Required (R) or Optional (O)	Data Type & Length
ccCaptureService_purchasingLevel	No corresponding GPN 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 GPN 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_merchantVATRegistrationNumber	Merchant VAT Number	Your government-assigned tax identification number.	Level III ■ Visa (O) ■ Mastercard (O)	String (20)
invoiceHeader_purchaserOrderDate	Order Date	Date the order was processed. Format: YYMMDD.	Level III ■ Visa (O) ■ Mastercard (O)	String (6)
invoiceHeader_purchaserVATRegistrationNumber	Customer VAT Number	Customer’s government-assigned tax identification number.	Level III ■ Visa (O) ■ Mastercard (O)	Visa: String (15) Mastercard: String (20)
invoiceHeader_summaryCommodityCode	Summary Commodity Code and Commodity Code	International description code of the overall order’s goods or services. Contact your acquirer or GPN for a list of codes. This field might be required for Level III processing depending on your merchant category code. Check with your processor.	Level III ■ Visa (O) ■ Mastercard (O)	String (4)
invoiceHeader_supplierOrderReference	Item Description	Text description of the item.	Level III ■ Visa (O) ■ Mastercard (O)	String (25)
invoiceHeader_userPO	Market Data - “m” Customer Code and Reference Number	Value used by your customer to identify the order. This value is typically a purchase order number.	Level II ■ Visa (R) ■ Mastercard (R)   Level III ■ Visa (R) ■ Mastercard (R)	Visa: String (17) Mastercard: String (25)
otherTax_alternateTaxAmount	Other Tax	Total amount of alternate tax for the order. Maximum amount is 99,999.99.	Level III ■ Visa (O)	String (12)
otherTax_nationalTaxAmount	National Tax	National tax for the order. Maximum amount is 99,999.99.	Level III ■ Visa (O)	String (12)
otherTax_vatTaxAmount	VAT/Tax Amount (Freight/Shipping)	Tax amount applied to freight / shipping costs.	Level III ■ Visa (O)	String (12)
otherTax_vatTaxRate	VAT/Tax Rate (Freight/Shipping)	Tax rate applied to freight / shipping costs. Example 0.040 (=4%)	Level III ■ Visa (O)	String (4)
purchaseTotals_discountAmount	Discount Amount	Total discount applied to the order. For example: a 20.00 discount off the order total. Maximum amount is 99,999.99. This field might be required for Level III processing depending on your merchant category code. Check with your processor.	Level III ■ Visa (O) ■ Mastercard (O)	String (12)
purchaseTotals_dutyAmount	Duty Amount	Total charges for any import or export duties included in the order. Maximum amount is 99,999.99.	Level III ■ Visa (O) ■ Mastercard (O)	String (12)
purchaseTotals_freightAmount	Freight Amount	Total freight or shipping and handling charges for the order. Maximum amount is 99,999.99. When you include this field in your request, you must also include purchaseTotals_grandTotalAmount.	Level III ■ Visa (O) ■ Mastercard (O)	String (12)
shipFrom_postalCode	Ship From Postal/Zip Code	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 III ■ Visa (O) ■ Mastercard (O)	String (10)
shipTo_country	Destination Country Code	Country of the shipping address. Use the two-character ISO Standard Country Codes.	Level III ■ Visa (O) ■ Mastercard (O)	String (2)
shipTo_postalCode	Destination Postal/Zip Code	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.	Level III ■ Visa (O) ■ Mastercard (O)	String (10)
shipTo_state	Destination State/Province Code	State or province of the shipping address. Use the State, Province, and Territory Codes for the United States and Canada.	Level III ■ Visa (O) ■ Mastercard (O)	String (2)