Order-Level Fields

Table 14

Order-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
ccCaptureService_purchasingLevel	No corresponding RBS WorldPay Atlanta 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)
invoiceHeader_merchantVATRegistrationNumber	Merchant VAT Number	Your government-assigned tax identification number.	Level III ■ Visa (O)	String (20)
invoiceHeader_purchaserOrderDate	Order Date	Date the order was processed. Format: YYMMDD.	Level III ■ Visa (O)	Numeric (6)
invoiceHeader_purchaserVATRegistrationNumber	Customer VAT Number	Customer’s government-assigned tax identification number.	Level III ■ Visa (O)	String (13)
invoiceHeader_summaryCommodityCode	Commodity Code	International description code of the overall order’s goods or services. Contact your acquirer for a list of codes.	Level III ■ Visa (O)	String (4)
invoiceHeader_taxable	Tax Exempt	Flag that indicates whether an order is taxable. Possible values: ■ true: the order is taxable. ■ false: the order is not taxable. Note This field is required for Visa and Mastercard transactions that involve Level II data. If item_#_taxAmount equals 0, set this field to false. If item_#_taxAmount is greater than 0, set this field to true.	Level II ■ Visa (R) ■ Mastercard (R)   Level III ■ Visa (R) ■ Mastercard (R)	String (5)
invoiceHeader_userPO	PC2 Customer ID	Value used by your customer to identify the order. This value is typically a purchase order number.	Level II ■ Visa (R for purchase/procurement cards; otherwise O. Do not use all zeros or nines.) ■ Mastercard (R for purchase/procurement cards; otherwise O. Do not use all zeros or nines.)   Level III ■ Visa (R for purchase/procurement cards; otherwise O. Do not use all zeros or nines.) ■ Mastercard (R for purchase/procurement cards; otherwise O. Do not use all zeros or nines.)	String (25)
invoiceHeader_vatInvoiceReferenceNumber	VAT Invoice Number	VAT invoice number associated with the transaction.	Level III ■ Visa (O)	String (15)
otherTax_alternateTaxAmount	VAT Tax Amount	Total amount of alternate tax for the order.	Level III ■ Visa (O) ■ Mastercard (O)	String (8)
otherTax_alternateTaxIndicator	Alternate 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 III ■ Mastercard (R)	String (1)
otherTax_vatTaxAmount	VAT Tax Amount	Total amount of VAT or other tax included in the order.	Level III ■ Visa (O)	Numeric (8)
otherTax_vatTaxRate	Tax Rate	Rate of VAT or other tax for the order. Example 0.0400 (=4%) Valid range: 0.0001 to 0.9999 (0.01% to 99.99%)	Level III ■ Visa (O)	Numeric (4)
purchaseTotals_discountAmount	Discount Amount	Total discount applied to the order. For example: a 20.00 discount off the order total.	Level III ■ Visa (O)	Numeric (8)
purchaseTotals_dutyAmount	Duty Amount	Total charges for any import or export duties included in the order.	Level III ■ Visa (O) ■ Mastercard (O)	Numeric (8)
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)	Numeric (8)
purchaseTotals_grandTotalAmount	Amount	Grand total for the entire capture or credit request.	Level III ■ Visa (R) ■ Mastercard (R)	String (15)
shipFrom_postalCode	Origin 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 III ■ Visa (Recommended) ■ Mastercard (Recommended)	String (10)
shipTo_country	Destination Country Code	Country of the shipping address. Use the two-character ISO Standard Country Codes.   If the request does not include this value, CyberSource uses the billTo_country value. If you do not provide either of these values, CyberSource uses the default value of US.	Level III ■ Visa (Recommended for best rate) ■ Mastercard (Recommended for best rate)	String (3)
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   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 III ■ Visa (Recommended for best rate) ■ Mastercard (Recommended for best rate)	String (10)