Order-Level Fields

Table 2

Order-Level Fields for Chase Paymentech Solutions

CyberSource Field Name	Chase Paymentech Solutions Field Name	Description	Used By: Required (R) or Optional (O)	Data Type & Length
ccCaptureService_purchasingLevel	No corresponding Chase Paymentech Solutions 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 Chase Paymentech Solutions 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_amexDataTAA1 invoiceHeader_amexDataTAA2 invoiceHeader_amexDataTAA3 invoiceHeader_amexDataTAA4	TAA1 TAA2 TAA3 TAA4	Four transaction advice addendum fields. These fields are used to display descriptive information about a transaction on your customer’s American Express card statement. If you are sending any TAA fields, start with invoiceHeader_amexDataTAA1, then ...TAA2, and so on. Skipping a TAA field causes subsequent TAA fields to be ignored. Contact CyberSource Customer Support if you plan to use these fields so that your account can be configured appropriately. The invoiceHeader_amexDataTAA1 field is required for Level II transactions for American Express cards for Chase Paymentech Solutions, but the other TAA fields are optional. However, if you are including the request ID (ccCreditService_captureRequestID) in a Level II credit request, you are not required to include invoiceHeader_amexDataTAA1.	Level II ■ American Express (See description)	String (40)
invoiceHeader_userPO	Customer Reference Number	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) ■ American Express (R for purchase/procurement cards; otherwise O)   Level III ■ Visa (R for purchase/procurement cards; otherwise O) ■ Mastercard (R for purchase/procurement cards; otherwise O)	String (25)
otherTax_alternateTaxAmount	Alternate Tax Amount	Total amount of alternate tax for the order.	Level III ■ Mastercard (O)	String (10)
otherTax_alternateTaxID	Alternate Tax ID	Your tax ID number to use for the alternate tax amount. Required if you set Alternate Tax Amount to any value, including zero. You may send this field without sending Alternate Tax Amount.	Level III ■ Mastercard (See description)	String (15)
otherTax_vatTaxAmount	VAT/Tax Amount	Total amount of VAT or other tax included in the order.	Level III ■ Visa (O)	String (13)
otherTax_vatTaxRate	VAT/Tax Rate	Rate of VAT or other tax for the order. Example 0.040 (=4%) Valid range: 0.01 to 0.99 (1% to 99%, with only whole percentage values accepted; values with additional decimal places will be truncated)	Level III ■ Visa (O)	String (4)
purchaseTotals_discountAmount	Discount Amount Applied to Order	Total discount applied to the order. For example: a 20.00 discount off the order total.	Level III ■ Visa (R for Level III interchange)	String (13)
purchaseTotals_dutyAmount	Duty Amount	Total charges for any import or export duties included in the order.	Level III ■ Visa (R for Level III interchange) ■ Mastercard (R for Level III interchange)	Visa: String (13) Mastercard: String (10)
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 (R for Level III interchange) ■ Mastercard (R for Level III interchange)	Visa: String (13) Mastercard: String (10)
purchaseTotals_grandTotalAmount	No corresponding Chase Paymentech Solutions 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	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 (R for best rate. Do not use all zeros or nines.)	String (10)
shipTo_country	Destination Country Code	Country of the shipping address. Use the two-character ISO Standard Country Codes.	Level III ■ Visa (R for best rate) ■ Mastercard (O but recommended)	String (2)
shipTo_postalCode	Destination ZIP/Postal 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 (R for best rate) ■ Mastercard (R for best rate. Do not use all zeros or nines.)	String (10)