Level II and Level III Field Requirements

Total amount of alternate tax for the order.

■	MasterCard

Indicates if an alternate tax amount is included in the order total. Possible values:

■	Y: Alternate tax is included

■	N: Alternate tax not included (Default)

■	MasterCard

Merchant's tax ID number to use for the alternate tax amount.

Four Transaction Advice Addendum fields. These fields are used to display descriptive information about a transaction on the consumer's American Express card statement. If you are sending any TAA fields, start with invoiceHeader_

DataTAA1, 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.

Total charges for any import or export duties included in the order.

■

■	MasterCard

Total freight or shipping and handling charges for the order.

■

■	MasterCard

Level II (Required for purchase/procurement cards; optional otherwise. Do not use all zeros or nines.)

■

Level III (Required for purchase/procurement cards; optional otherwise. Do not use all zeros or nines.)

■	MasterCard

■

■	MasterCard

Sales tax for the order.

■

■	MasterCard

Indicates if the order includes local tax. This field is not included in the request when you select the following:

■	The default setting

■	Local Tax Not Included

■	Local Tax Included

■	Tax Exempt

Important For GSA (General Services Administration) purchasing cards, tax is required in order to qualify for Level III when processing with TSYS Acquiring Solutions. Therefore, the only valid Level III value for this field for GSA cards is Local Tax Included. If you have any questions or concerns, please contact your acquirer.

■

■	MasterCard

Merchant’s government-assigned tax identification number.

■

National tax for the order.

■

■	MasterCard

Indicates if a national tax is included in the order total. Possible values:

■	0: National tax not included

■	1: National tax included

If you do not provide a value, CyberSource sets this field to 1 if you provide a National Tax Amount greater than 0.

■

■	MasterCard

Total discount applied to the order. For example: a $20 discount off the order total.

■

Customer ID reference number that identifies the customer for a Level II transaction.

■

Customer’s government-assigned tax identification number.

■

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

■

■	MasterCard (Recommended for best rate. Do not use all zeros or nines.)

International description code of the overall order’s goods or services. Contact your acquirer for a list of codes.

■

Indicates if an order is taxable. Possible values:

■	N (Default)

■	Y (if checked)

VAT invoice number associated with the transaction.

■

Total amount of VAT or other tax included in the order.

■

■

Item-Level Fields Required for TSYS

Table 2

Item-Level Field Requirements for TSYS

Merchant’s tax ID number to use for the alternate tax amount.

Provide this field if you include Alternate Tax Amount in the request.

You may send this field without sending Alternate Tax Amount.

■	MasterCard

MasterCard: Tax rate for a type of tax collected. Visa: VAT or other tax rate.

MasterCard: Flag that defines tax categories for domestic processing in certain locations. Visa: VAT or other tax type.

Flag that indicates the type of tax collected.

■

■

■	MasterCard

■

■	MasterCard

International description code used to classify the item. Contact your acquirer for a list of codes.

■

■

■	MasterCard

Flag that indicates if the amount is discounted. Possible values:

■	Y: Amount is discounted

■	N: Amount is not discounted

If you do not provide a value but you set Discount Amount to a value greater than zero, CyberSource sets this field to Y.

■	MasterCard

Example: .0525 (=5.25%)

■	MasterCard

Flag that indicates if the tax amount is included in the Line Item Total. Possible values:

■	Y: Item amount includes tax amount

■	N: Item amount does not include tax amount

■	MasterCard

Product's identifier code.

Amount of national tax or value added tax for countries where more than one tax is applied

Product code for the item. In the United States, this may be a UPC code, part number, or product number. If you do not provide this value, CyberSource uses default.

■

■	MasterCard (Recommended for best rate. Do not use all zeros or spaces.)

■

■	MasterCard (R. Do not use all zeros or spaces.)

Number of units of the item purchased. Must be a whole number. If you do not provide this value, CyberSource uses 1.

Level III (Recommended for best rate)

■

■	MasterCard (Do not use all zeros or spaces.)

Total tax to apply to the product.

■

■	MasterCard

■

■	MasterCard

■

■	MasterCard (R)

Type of tax being applied to the item.

■	MasterCard

Total purchase amount for the item. Normally calculated as the unit price x quantity.

■

■	MasterCard (Do not use all zeros or spaces.)

Unit of measure, or unit of measure code, for the item.

■

■	MasterCard (R. Do not use all zeros or spaces.)

Rate used to calculate VAT

Order-Level Fields Required for FDC Nashville Global

FDC Nashville Global

Table 3

Order-Level Field Requirements for FDC Nashville Global

Level II (Required for non-U.S. transactions; otherwise, not used)

Amount of all taxes, excluding the local tax (Tax Amount) and national tax (National Tax) included in the total tax.

Note Do not confuse this order-level field with the alternate Tax Amount offer-level field.

■

Level III (Optional for non-U.S. transactions; otherwise, not used)

■	MasterCard

■	American Express

■

■	MasterCard

Level II (Required for non-U.S. MasterCard transactions; otherwise, not used)

Indicates if the alternate tax amount (Alternate Tax Amount) is included in the request. Possible values:

■	N: Alternate tax amount is not included in the request.

■	Y: Alternate tax amount is included in the request.

Level III (Optional for non-U.S. MasterCard transactions; otherwise, not used)

■	MasterCard

■	MasterCard

Merchant's tax ID number to use for the alternate tax amount.

Four Transaction Advice Addendum fields. These fields are used to display descriptive information about a transaction on the consumer’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.

Total charges for any import or export duties included in the order. This value cannot be negative.

■

Total freight or shipping and handling charges for the order.

■	MasterCard (O)

■

■

■	MasterCard

CyberSource recommends that you do not populate the field with all zeros or nines.

Customer’s purchase order number. A value must be provided in this field or in the Merchant Reference Number field.

Level II (See description)

■

■	MasterCard

■	American Express

■

■	MasterCard

Indicates if the order includes local tax. This field is not included in the request when you select the following:

■	The default setting

■	Local Tax Not Included

■	Local Tax Included

■	Tax Exempt

Identification number assigned to the purchasing company by the tax authorities.

Amount of national sales tax or value-added tax for the order

Indicates if the order includes national tax. Possible values:

■	0 (Default)

■	1 (if checked)

Total discount applied to the order. For example: a $20 discount off the order total. This value cannot be negative.

■

Customer ID reference number that identifies the customer for a Level II transaction.

■	MasterCard (O)

■

Date the order was processed.

Identification number assigned to the purchasing company by the tax authorities.

Level II (Required for non-U.S. Visa transactions; otherwise, not used)

■

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

■

■	MasterCard

■

■	MasterCard

International description code of the overall order’s goods or services. Contact your acquirer for a list of codes.

■

■	MasterCard (Required for reduced interchange)

Indicates if an order is taxable. Possible values:

■	N (Default)

■	Y (if checked)

VAT invoice number associated with the transaction.

Level II (Required for non-U.S. Visa transactions; otherwise, not used)

■

Total amount of VAT or other tax on freight or shipping only.

Level II (Optional for non-U.S. transactions; otherwise, not used)

■

Vat tax rate for freight or shipping.

■	MasterCard

■	American Express

VAT Tax Rate

Level II (Optional for non-U.S. transactions; otherwise, not used)

■

Item-Level Fields Required for FDC Nashville Global

■	MasterCard

■	American Express

Table 4

Item-Level Field Requirements for FDC Nashville Global

MasterCard: Tax amount collected for a special type of tax.

Visa: VAT or other tax amount.

Note Do not confuse this offer-level field with the Alternate Tax Amount order-level field.

■

■	MasterCard

Merchant’s tax ID number to use for the alternate tax amount.

Level III (Required if alternate_tax_amount is included; otherwise, optional.)

■	MasterCard

MasterCard: Tax rate for a type of tax collected.

Visa: VAT or other tax rate.

■

■	MasterCard

MasterCard: Flag that defines tax categories for domestic processing in certain locations.

Visa: VAT or other tax type.

■

■	MasterCard

Flag that indicates the type of tax collected for Alternate Tax Amount.

■

■	MasterCard

■

■	MasterCard

■	American Express

■

■	MasterCard

International description code used to classify the item. Contact your acquirer or FDC Nashville Global for a list of codes.

■

■	MasterCard (O)

■

■	MasterCard

■

■	MasterCard

■	MasterCard

Flag that indicates if the tax amount is included in the Line Item Total. Possible values:

■	Y: Item amount includes tax amount

■	N: Item amount does not include tax amount

Not Supported

■

■	MasterCard

Product’s identifier code.

■

■	MasterCard

Number of units of the item purchased. Must be a whole number. If you do not provide this value, CyberSource uses 1.

■

■	MasterCard (Required for reduced interchange)

Product code for the item. In the United States, this may be a UPC code, part number, or product number.

■

■	MasterCard (Required for reduced interchange)

Number of units of the item purchased. Must be a whole number. If you do not provide this value, CyberSource uses 1.

■

■	MasterCard (Required for reduced interchange)

Total tax to apply to the product. This value cannot be negative. The tax_amount field is additive. For example, if you include the following offer lines:

the total amount authorized will be for $32.40, not $30.00 with $2.40 of tax included. The tax_amount and the amount must be in the same currency.

If you want to include tax_amount and also request the ics_tax service, see the Tax Calculation Implementation Guide.

Note This value is the sales tax. For Visa transactions, this value must be between 0.1% and 22% of the total sale.

■

■	MasterCard

■	American Express

■

■	MasterCard (R)

Type of tax being applied to the item.

■	MasterCard

Total purchase amount for the item. Normally calculated as the unit price x quantity.

■

■	MasterCard (Do not use all zeros or spaces.)

Unit of measure, or unit of measure code, for the item.

■

■	MasterCard (Required for reduced interchange)

Rate used to calculate VAT

Order-Level Fields Required for GPN

GPN

Table 5

Order-Level Field Requirements for GPN

Total amount of alternate tax for the order. Maximum amount is 99,999.99.

■

Indicates if the order includes alternate tax. Possible values:

■	N (Default)

■	Y (if checked)

Merchant's tax ID number to use for the alternate tax amount.

Four Transaction Advice Addendum fields. These fields are used to display descriptive information about a transaction on the consumer’s American Express card statement. If you are sending any TAA fields, start with invoiceHeader_TAA1, then ...TAA2, and so on. Skipping a TAA field causes subsequent TAA fields to be ignored.

Total charges for any import or export duties included in the order. Maximum amount is 99,999.99.

■

■	MasterCard

Total freight or shipping and handling charges for the order. Maximum amount is 99,999.99.

■

■	MasterCard

■

■	MasterCard

■

■	MasterCard

Indicates if the order includes local tax. This field is not included in the request when you select the following:

■	The default setting

■	Local Tax Not Included

■	Local Tax Included

■	Tax Exempt

Merchant’s government-assigned tax identification number.

■

■	MasterCard

National tax for the order. Maximum amount is 99,999.99.

■

Indicates if the order includes national tax. Possible values:

■	0 (Default)

■	1 (if checked)

Total discount applied to the order. For example: a $20 discount off the order total. Maximum amount is 99,999.99.

■

■	MasterCard

Customer ID reference number that identifies the customer for a Level II transaction.

■

■	MasterCard

Customer’s government-assigned tax identification number.

■

■	MasterCard

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

■

■	MasterCard

International description code of the overall order’s goods or services. Contact your acquirer or GPN for a list of codes.

■

■	MasterCard

■

■	MasterCard

Indicates if an order is taxable. Possible values:

■	N (Default)

■	Y (if checked)

VAT invoice number associated with the transaction.

Tax amount applied to freight/shipping costs.

■

Tax rate applied to freight / shipping costs.

■

Item-Level Fields Required for GPN

Table 6

Item-Level Field Requirements for GPN

Merchant's tax ID number to use for the alternate tax amount.

■

■	MasterCard

MasterCard: Flag that defines tax categories for domestic processing in certain locations. Visa: VAT or other tax type

Unit cost of the item purchased. Maximum amount is 99,999.99.

Note For each offer line that you include in a request, you must include a Unit Price field.

■

■	MasterCard

■

■	MasterCard

International description code used to classify the item. Contact your acquirer or GPN for a list of codes.

■

■	MasterCard

Discount applied to the item. Maximum amount is 99,999.99.

■

■	MasterCard

Flag that indicates if the amount is discounted. Possible values:

■	N (Default)

■	Y (if checked)

■	MasterCard

Flag that indicates if the tax amount is included in the Line Item Total. Possible values:

■	N (Default)

■	Y (if checked)

Product's identifier code.

Amount of national tax or value added tax for countries where more than one tax is applied.

Product code for the item. In the United States, this may be a UPC code, part number, or product number. If you do not provide this value, CyberSource uses default.

■

■	MasterCard

Number of units of the item purchased. Must be a whole number. If you do not provide this value, CyberSource uses 1.

■

■	MasterCard

Maximum amount is 99,999.99.

Total tax to apply to the product. This value cannot be negative. The Tax Amount field is additive. For example, if you include the following offer lines:

the total amount authorized will be for $32.40, not $30.00 with $2.40 of tax included. The Tax Amount and the Unit Price must be in the same currency.

Note For Level II, this value is the sales tax. For Visa Level II transactions, this value must be zero or must be between 0.1% and 22% of the total sale.

■

■	MasterCard

■

■	MasterCard

Type of tax being applied to the item

Total purchase amount for the item

Unit of measure for the item.

■

■	MasterCard

Rate used to calculate VAT

Order-Level Fields Required for RBS WorldPay Atlanta

RBS WorldPay Atlanta

Table 7

Order-Level Field Requirements for RBS WorldPay Atlanta

Total amount of alternate tax included in the order. Amount cannot be greater than $999999.99.

■	MasterCard

Indicates if the alternate tax amount is included in the request. Possible values:

■	N: Alternate tax amount is not included in the request.

■	Y: Alternate tax amount is included in the request.

■	MasterCard

Merchant's tax ID number to use for the alternate tax amount.

Contact CyberSource Customer Support if you plan to use these fields so that your account can be configured appropriately.

Total charges for any import or export duties included in the order.

■

■	MasterCard

Total freight or shipping and handling charges for the order.

■

■	MasterCard

Level II (Required for purchase/procurement cards; optional otherwise. Do not use all zeros or nines.)

■

Level III (Required for purchase/procurement cards; optional otherwise. Do not use all zeros or nines.)

■	MasterCard

■

■	MasterCard

Indicates if the order includes local tax. This field is not included in the request when you select the following:

■	The default setting

■	Local Tax Not Included

■	Local Tax Included

■	Tax Exempt

Merchant’s government-assigned tax identification number.

■

Amount of national sales tax or value-added tax for the order.

Indicates if the order includes national tax. Possible values:

■	0 (Default)

■	1 (if checked)

Total discount applied to the order. For example: a $20 discount off the order total. Discount amount cannot be greater than $999999.99.

■

Customer ID reference number that identifies the customer for a Level II transaction.

■

Customer’s government-assigned tax identification number.

■

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

■	Visa (Recommended)

■	MasterCard (Recommended)

International description code of the overall order’s goods or services. Contact your acquirer for a list of codes.

■

If the taxable amount is 0, the tax indicator is required.

■	N: The order is taxable.

■	Y: The order is tax exempt

■

■	MasterCard

■

■	MasterCard

VAT invoice number associated with the transaction.

■

Total amount of VAT or other tax included in the order. Amount cannot be greater than $999999.99.

■

■

Item-Level Fields Required for RBS WorldPay Atlanta

Table 8

Item-Level Field Requirements for RBS WorldPay Atlanta

Merchant’s tax ID number to use for the alternate tax amount.

Provide this field if you include Alternate Tax Amount in the request.

You may send this field without sending Alternate Tax Amount.

■	MasterCard

MasterCard: Tax rate for a type of tax collected. Visa: VAT or other tax rate

MasterCard: Flag that defines tax categories for domestic processing in certain locations. Visa: VAT or other tax type.

International description code used to classify the item. Contact your acquirer for a list of codes.

■

■

■	MasterCard

Flag that indicates if the amount is discounted. Possible values:

■	N (Default)

■	Y (if checked)

■	MasterCard

Flag that indicates if the tax amount is included in the Line Item Total. Possible values:

■	Y: Item amount includes tax amount

■	N: Item amount does not include tax amount

■	MasterCard

Amount of national sales tax or value-added tax for the order.

Product code for the item. In the United States, this may be a UPC code, part number, or product number. If you do not provide this value, CyberSource uses default.

■

■	MasterCard (R)

■

■	MasterCard (R. Do not use all zeros or spaces.)

The quantity of the items purchased. Cannot be more than 999999.99.

Level III (Recommended for best rate)

■

■	MasterCard

Total tax to apply to the product. This value cannot be negative. If no tax is present, you can send in a value of 0.

The Tax Amount field is additive. For example, if you include the following offer lines:

The total amount authorized will be for $32.40, not $30.00 with $2.40 of tax included. The Tax Amount and the Unit Price must be in the same currency.

■

■	MasterCard

■

■	MasterCard

Valid range is 0.0001 to 0.9999 (0.01% to 99.99%). The value can also be zero.

■

■	MasterCard (O)

Type of tax being applied to the item. Possible values:

■	0000: Unknown tax type

■	0001: Federal/National sales tax

■	0002: State sales tax

■	0003: City sales tax

■	0004: Local sales tax

■	0005: Municipal sales tax

■	0006: Other tax

■	0010: Value added tax

■	0011: Goods and services tax

■	0012: Provincial sales tax

■	0013: Harmonized sales tax

■	0014: Quebec sales tax (QST)

■	0020: Room tax

■	0021: Occupancy tax

■	0022: Energy tax

■	MasterCard

Total purchase amount for the item. Normally calculated as the unit price x quantity.

■

■	MasterCard (Do not use all zeros or spaces.)

Unit of measure, or unit of measure code, for the item.

■

■	MasterCard (R)

Order-Level Fields Required for FDC Compass

FDC Compass

Table 9

Order-Level Field Requirements for FDC Compass

Total amount of alternate tax included in the order. Amount cannot be greater than $999999.99.

■	MasterCard

Indicates if the alternate tax amount is included in the request. Possible values:

■	N: Alternate tax amount is not included in the request.

■	Y: Alternate tax amount is included in the request.

Merchant's 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.

■	MasterCard

Contact CyberSource Customer Support if you plan to use these fields so that your account can be configured appropriately.

Transaction Advice Addendum 1 is required for Level II transactions for American Express cards, but the other TAA fields are optional.

Level II (see description)

■	Cards: American Express

Total charges for any import or export duties included in the order.

■

■	MasterCard

Total freight or shipping and handling charges for the order.

■

■	MasterCard

Level II (Required for purchase/procurement cards; optional otherwise. Do not use all zeros or nines.)

■

Level III (Required for purchase/procurement cards; optional otherwise. Do not use all zeros or nines.)

■	MasterCard

■

■	MasterCard

Indicates if the order includes local tax. This field is not included in the request when you select the following:

■	The default setting

■	Local Tax Not Included

■	Local Tax Included

■	Tax Exempt

Merchant’s government-assigned tax identification number.

Amount of national sales tax or value-added tax for the order.

Indicates if the order includes national tax. Possible values:

■	0 (Default)

■	1 (if checked)

Total discount applied to the order. For example: a $20 discount off the order total. Discount amount cannot be greater than $999999.99.

■

Customer ID reference number that identifies the customer for a Level II transaction.

Customer’s government-assigned tax identification number.

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

■	Visa (Recommended)

■	MasterCard (Required for best rate. Do not use all zeros or nines.)

International description code of the overall order’s goods or services. Contact your acquirer for a list of codes.

If the taxable amount is 0, the tax indicator is required.

■	N: The order is taxable.

■	Y: The order is tax exempt

VAT invoice number associated with the transaction.

Total amount of VAT or other tax included in the order. Amount cannot be greater than $999999.99.

■

■

Item-Level Fields Required for FDC Compass

Table 10

Item-Level Field Requirements for FDC Compass

Merchant’s tax ID number to use for the alternate tax amount.

Provide this field if you include Alternate Tax Amount in the request.

You may send this field without sending Alternate Tax Amount.

MasterCard: Tax rate for a type of tax collected. Visa: VAT or other tax rate

MasterCard: Flag that defines tax categories for domestic processing in certain locations. Visa: VAT or other tax type.

■

■	MasterCard

■	American Express

■

■	MasterCard

International description code used to classify the item. Contact your acquirer for a list of codes.

■

■

■	MasterCard

Flag that indicates if the amount is discounted. Possible values:

■	N (Default)

■	Y (if checked)

■	MasterCard

Flag that indicates if the tax amount is included in the Line Item Total. Possible values:

■	Y: Item amount includes tax amount

■	N: Item amount does not include tax amount

■	MasterCard

Amount of national sales tax or value-added tax for the order.

Product code for the item. In the United States, this may be a UPC code, part number, or product number. If you do not provide this value, CyberSource uses default.

■

■	MasterCard (Do not use all zeros or spaces)

■

■	MasterCard (Do not use all zeros or spaces)

The quantity of the items purchased. Cannot be more than 999999.99.

■

■	MasterCard (Do not use all zeros or spaces)

Total tax to apply to the product. This value cannot be negative. If no tax is present, you can send in a value of 0.

The Tax Amount field is additive. For example, if you include the following offer lines:

The total amount authorized will be for $32.40, not $30.00 with $2.40 of tax included. The Tax Amount and the Unit Price must be in the same currency.

■

■	MasterCard

■	American Express

■

■	MasterCard

Valid range is 0.0001 to 0.9999 (0.01% to 99.99%). The value can also be zero.

■

■	MasterCard

Type of tax being applied to the item. Possible values:

■	0000: Unknown tax type

■	0001: Federal/National sales tax

■	0002: State sales tax

■	0003: City sales tax

■	0004: Local sales tax

■	0005: Municipal sales tax

■	0006: Other tax

■	0010: Value added tax

■	0011: Goods and services tax

■	0012: Provincial sales tax

■	0013: Harmonized sales tax

■	0014: Quebec sales tax (QST)

■	0020: Room tax

■	0021: Occupancy tax

■	0022: Energy tax

■	MasterCard

Total purchase amount for the item. Normally calculated as the unit price x quantity.

■

■	MasterCard (Do not use all zeros or spaces)

Unit of measure, or unit of measure code, for the item.

■

■	MasterCard (Must not be all zeros or spaces)

Order-Level Fields Required for Chase Paymentech

Chase Paymentech

Table 11

Order-Level Field Requirements for Chase Paymentech

Total amount of alternate tax included in the order. Amount cannot be greater than $999999.99.

■	MasterCard

Indicates if the alternate tax amount is included in the request. Possible values:

■	N: Alternate tax amount is not included in the request.

■	Y: Alternate tax amount is included in the request.

Merchant's 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.

■	MasterCard

Contact CyberSource Customer Support if you plan to use these fields so that your account can be configured appropriately.

Transaction Advice Addendum 1 is required for Level II transactions for American Express cards, but the other TAA fields are optional.

Level II (see description)

■	Cards: American Express

Total charges for any import or export duties included in the order.

■

■	MasterCard

Total freight or shipping and handling charges for the order.

■

■	MasterCard

Level II (Required for purchase/procurement cards; optional otherwise. Do not use all zeros or nines.)

■

Level III (Required for purchase/procurement cards; optional otherwise. Do not use all zeros or nines.)

■	MasterCard

■

■	MasterCard

Indicates if the order includes local tax. This field is not included in the request when you select the following:

■	The default setting

■	Local Tax Not Included

■	Local Tax Included

■	Tax Exempt

Merchant’s government-assigned tax identification number.

Amount of national sales tax or value-added tax for the order.

Indicates if the order includes national tax. Possible values:

■	0 (Default)

■	1 (if checked)

Total discount applied to the order. For example: a $20 discount off the order total. Discount amount cannot be greater than $999999.99.

■

Customer ID reference number that identifies the customer for a Level II transaction.

Customer’s government-assigned tax identification number.

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

■	Visa (Recommended)

■	MasterCard (Required for best rate. Do not use all zeros or nines.)

International description code of the overall order’s goods or services. Contact your acquirer for a list of codes.

If the taxable amount is 0, the tax indicator is required.

■	N: The order is taxable.

■	Y: The order is tax exempt

Customer’s purchase order number. CyberSource recommends that you do not populate the field with all zeros or nines.

User PO

Level II (Required for purchase/procurement cards; optional otherwise)

■

Level III (Required for purchase/procurement cards; optional otherwise)

■	MasterCard

■	American Express

■

■	MasterCard

VAT invoice number associated with the transaction.

Total amount of VAT or other tax included in the order. Amount cannot be greater than $999999.99.

■

■

Item-Level Fields Required for Chase Paymentech

Table 12

Item-Level Field Requirements for Chase Paymentech

Merchant’s tax ID number to use for the alternate tax amount.

Provide this field if you include Alternate Tax Amount in the request.

You may send this field without sending Alternate Tax Amount.

MasterCard: Tax rate for a type of tax collected. Visa: VAT or other tax rate

MasterCard: Flag that defines tax categories for domestic processing in certain locations. Visa: VAT or other tax type.

International description code used to classify the item. Contact your acquirer for a list of codes.

■

Visa: Discount Amount for Line Item.

MasterCard: Discount Amount.

■

■	MasterCard

Flag that indicates if the amount is discounted. Possible values:

■	N (Default)

■	Y (if checked)

Level III (Eequired for Level III interchange)

■	MasterCard

Flag that indicates if the tax amount is included in the Line Item Total. Possible values:

■	Y: Item amount includes tax amount

■	N: Item amount does not include tax amount

■	MasterCard

Amount of national sales tax or value-added tax for the order.

Product code for the item. In the United States, this may be a UPC code, part number, or product number. If you do not provide this value, CyberSource uses default.

■

■	MasterCard (Do not use all zeros or spaces)

■

■	MasterCard (Do not use all zeros or spaces)

The quantity of the items purchased. Cannot be more than 999999.99.

■

■	MasterCard (Do not use all zeros or spaces)

Total tax to apply to the product. This value cannot be negative. If no tax is present, you can send in a value of 0.

The Tax Amount field is additive. For example, if you include the following offer lines:

The total amount authorized will be for $32.40, not $30.00 with $2.40 of tax included. The Tax Amount and the Unit Price must be in the same currency.

■

■	MasterCard

■	American Express

■

■	MasterCard

Valid range is 0.0001 to 0.9999 (0.01% to 99.99%). The value can also be zero.

■

■	MasterCard

Type of tax being applied to the item. Possible values:

■	0000: Unknown tax type

■	0001: Federal/National sales tax

■	0002: State sales tax

■	0003: City sales tax

■	0004: Local sales tax

■	0005: Municipal sales tax

■	0006: Other tax

■	0010: Value added tax

■	0011: Goods and services tax

■	0012: Provincial sales tax

■	0013: Harmonized sales tax

■	0014: Quebec sales tax (QST)

■	0020: Room tax

■	0021: Occupancy tax

■	0022: Energy tax

■	MasterCard

Total purchase amount for the item. Normally calculated as the unit price x quantity.

■

■	MasterCard (Do not use all zeros or spaces)

Unit of measure, or unit of measure code, for the item.

■

■	MasterCard (Must not be all zeros or spaces)

■

■	MasterCard

■	American Express

■

■	MasterCard

Order-Level Fields Required for FDMS Nashville

FDMS Nashville

Table 13

Order-Level Field Requirements for FDMS Nashville

Total amount of alternate tax included in the order. Amount cannot be greater than $999999.99.

Indicates if the alternate tax amount is included in the request. Possible values:

■	N: Alternate tax amount is not included in the request.

■	Y: Alternate tax amount is included in the request.

Merchant's 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.

Contact CyberSource Customer Support if you plan to use these fields so that your account can be configured appropriately.

Transaction Advice Addendum 1 is required for Level II transactions for American Express cards, but the other TAA fields are optional.

Total charges for any import or export duties included in the order.

Total freight or shipping and handling charges for the order.

Indicates if the order includes local tax. This field is not included in the request when you select the following:

■	The default setting

■	Local Tax Not Included

■	Local Tax Included

■	Tax Exempt

Merchant’s government-assigned tax identification number.

Amount of national sales tax or value-added tax for the order.

Indicates if the order includes national tax. Possible values:

■	0 (Default)

■	1 (if checked)

Total discount applied to the order. For example: a $20 discount off the order total. Discount amount cannot be greater than $999999.99.

Customer ID reference number that identifies the customer for a Level II transaction.

Customer’s government-assigned tax identification number.

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

■

■	MasterCard

International description code of the overall order’s goods or services. Contact your acquirer for a list of codes.

If the taxable amount is 0, the tax indicator is required.

■	N: The order is taxable.

■	Y: The order is tax exempt

■

Customer’s purchase order number. CyberSource recommends that you do not populate the field with all zeros or nines.

■	MasterCard

User PO

Level II (Required for purchase/procurement cards; optional otherwise)

■

■	MasterCard

VAT invoice number associated with the transaction.

Total amount of VAT or other tax included in the order. Amount cannot be greater than $999999.99.

VAT Tax Rate

Item-Level Fields Required for FDMS Nashville

Table 14

Item-Level Field Requirements for FDMS Nashville

Merchant’s tax ID number to use for the alternate tax amount.

Provide this field if you include Alternate Tax Amount in the request.

You may send this field without sending Alternate Tax Amount.

MasterCard: Tax rate for a type of tax collected. Visa: VAT or other tax rate

MasterCard: Flag that defines tax categories for domestic processing in certain locations. Visa: VAT or other tax type.

International description code used to classify the item. Contact your acquirer for a list of codes.

Visa: Discount Amount for Line Item.

MasterCard: Discount Amount.

Flag that indicates if the amount is discounted. Possible values:

■	N (Default)

■	Y (if checked)

Flag that indicates if the tax amount is included in the Line Item Total. Possible values:

■	Y: Item amount includes tax amount

■	N: Item amount does not include tax amount

Amount of national sales tax or value-added tax for the order.

Product code for the item. In the United States, this may be a UPC code, part number, or product number. If you do not provide this value, CyberSource uses default.

The quantity of the items purchased. Cannot be more than 999999.99.

Total tax to apply to the product. This value cannot be negative. If no tax is present, you can send in a value of 0.

The Tax Amount field is additive. For example, if you include the following offer lines:

The total amount authorized will be for $32.40, not $30.00 with $2.40 of tax included. The Tax Amount and the Unit Price must be in the same currency.

■

■	MasterCard

Valid range is 0.0001 to 0.9999 (0.01% to 99.99%). The value can also be zero.

Type of tax being applied to the item. Possible values:

■	0000: Unknown tax type

■	0001: Federal/National sales tax

■	0002: State sales tax

■	0003: City sales tax

■	0004: Local sales tax

■	0005: Municipal sales tax

■	0006: Other tax

■	0010: Value added tax

■	0011: Goods and services tax

■	0012: Provincial sales tax

■	0013: Harmonized sales tax

■	0014: Quebec sales tax (QST)

■	0020: Room tax

■	0021: Occupancy tax

■	0022: Energy tax

Total purchase amount for the item. Normally calculated as the unit price x quantity.

Unit of measure, or unit of measure code, for the item.

■

■	MasterCard

Order-Level Fields Required for FDMS South

FDMS South

Table 15

Order-Level Field Requirements for FDMS South

Total amount of alternate tax included in the order. Amount cannot be greater than $999999.99.

Indicates if the alternate tax amount is included in the request. Possible values:

■	N: Alternate tax amount is not included in the request.

■	Y: Alternate tax amount is included in the request.

Merchant's 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.

Contact CyberSource Customer Support if you plan to use these fields so that your account can be configured appropriately.

Transaction Advice Addendum 1 is required for Level II transactions for American Express cards, but the other TAA fields are optional.

Total charges for any import or export duties included in the order.

■	MasterCard

Total freight or shipping and handling charges for the order.

Indicates if the order includes local tax. This field is not included in the request when you select the following:

■	The default setting

■	Local Tax Not Included

■	Local Tax Included

■	Tax Exempt

Merchant’s government-assigned tax identification number.

Amount of national sales tax or value-added tax for the order.

Indicates if the order includes national tax. Possible values:

■	0 (Default)

■	1 (if checked)

Total discount applied to the order. For example: a $20 discount off the order total. Discount amount cannot be greater than $999999.99.

Customer ID reference number that identifies the customer for a Level II transaction.

Level II (Required for purchase/procurement cards; optional otherwise)

■

Customer’s government-assigned tax identification number.

■

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

■	MasterCard

International description code of the overall order’s goods or services. Contact your acquirer for a list of codes.

■

If the taxable amount is 0, the tax indicator is required.

■	N: The order is taxable.

■	Y: The order is tax exempt

■

Customer’s purchase order number. CyberSource recommends that you do not populate the field with all zeros or nines.

■	MasterCard

User PO

Level II (Required for purchase/procurement cards; optional otherwise)

■

■	MasterCard

VAT invoice number associated with the transaction.

Total amount of VAT or other tax included in the order. Amount cannot be greater than $999999.99.

VAT Tax Rate

Item-Level Fields Required for FDMS South

Table 16

Item-Level Field Requirements for FDMS South

Merchant’s tax ID number to use for the alternate tax amount.

Provide this field if you include Alternate Tax Amount in the request.

You may send this field without sending Alternate Tax Amount.

MasterCard: Tax rate for a type of tax collected. Visa: VAT or other tax rate

MasterCard: Flag that defines tax categories for domestic processing in certain locations. Visa: VAT or other tax type.

International description code used to classify the item. Contact your acquirer for a list of codes.

Visa: Discount Amount for Line Item.

MasterCard: Discount Amount.

Flag that indicates if the amount is discounted. Possible values:

■	N (Default)

■	Y (if checked)

Flag that indicates if the tax amount is included in the Line Item Total. Possible values:

■	Y: Item amount includes tax amount

■	N: Item amount does not include tax amount

Amount of national sales tax or value-added tax for the order.

■

■	MasterCard

Product code for the item. In the United States, this may be a UPC code, part number, or product number. If you do not provide this value, CyberSource uses default.

The quantity of the items purchased. Cannot be more than 999999.99.

Total tax to apply to the product. This value cannot be negative. If no tax is present, you can send in a value of 0.

The Tax Amount field is additive. For example, if you include the following offer lines:

The total amount authorized will be for $32.40, not $30.00 with $2.40 of tax included. The Tax Amount and the Unit Price must be in the same currency.

■

■	MasterCard

Valid range is 0.0001 to 0.9999 (0.01% to 99.99%). The value can also be zero.

Type of tax being applied to the item. Possible values:

■	0000: Unknown tax type

■	0001: Federal/National sales tax

■	0002: State sales tax

■	0003: City sales tax

■	0004: Local sales tax

■	0005: Municipal sales tax

■	0006: Other tax

■	0010: Value added tax

■	0011: Goods and services tax

■	0012: Provincial sales tax

■	0013: Harmonized sales tax

■	0014: Quebec sales tax (QST)

■	0020: Room tax

■	0021: Occupancy tax

■	0022: Energy tax

Total purchase amount for the item. Normally calculated as the unit price x quantity.

Unit of measure, or unit of measure code, for the item.

■

■	MasterCard

■