Developer's Guide

Gateway Developer Guide and Reference 07 January 2014 165
Submitting Purchasing Card Level 2 and 3 Transactions
About American Express Purchasing Card Transactions
D
Avoiding Downgrade
If a transaction uses the purchasing card BIN range (see “Accepted BIN Ranges” on page 166)
and contains a line item but does not include all mandatory Level 3 parameters, the transaction
succeeds but is processed as Level 2 or Level 1 during settlement (depending on which data
was passed).
For downgraded transactions, with the VERBOSITY parameter set to HIGH, the ADDLMSGS
field returns a message like the following:
Features not processed: PCARD L3 (missing or invalid: InvoiceNumber
RequestorName)
— or —
Features not processed: PCARD L3 (line item 3 missing: Description)
For details on VERBOSITY, see “VERBOSITY: Processor-Specific Transaction Results” on
page 221
Submitting Successful Level 3 Transactions
If a transaction uses the purchasing card BIN range, contains all mandatory Level 3 fields, and
has at least 1 line item (with all mandatory line item fields), the Gateway flags it as Level 3.
Edit Check
The Gateway performs an edit check on the transaction's amount fields to ensure that all line
item and tax amounts balance.
If the edit check fails, the transaction fails with Result 4: Invalid Amount.
To pass the edit check, the following relationship must be true:
Transaction Amount = Total Tax Amount + Total Freight Amount + Total
Handling Amount + Total Line Item Amount.
Transaction Amount Total amount for the transaction, AMT
Total Tax Amount TAXAMT
Total Freight Amount FREIGHTAMT, or, if not present, the summation of L_FREIGHTAMTn for all line
items
Total Handling Amount HANDLINGAMT, or, if not present, the summation of L_HANDLINGAMTn for all
line items
Total Line Item Amount Summation of L_QTYn * L_COSTn for all line items (n as the line item
number). For example, if there are 2 line items, then the Total Line Item Amount
would be (LQTY1*LCOST1) + (LQTY2*LCOST2)