Defines requierd fields and transaction handling behavior for Level III purchase card processing through the Remote API.

Level III Purchase Card Processing

Important Requirements

Merchant account must be configured specifically to accept Level III Purchase Card payments to use this functionality.

Level III Purchase Card processing provides enhanced commercial card transaction support by submitting detailed line-item and tax information during authorization processing.

Supported Merchant Accounts

  • Paytechtampa

Supported Card Brands

  • Visa
  • Mastercard

Settlement failures may occur if:

  1. Required Level III fields are not submitted.
  2. The combined values of quantity, cost, and tax do not equal the submitted card-amount.

Transaction Flags

The following transaction-level fields are required for all Level III Purchase Card transactions.

Variable Requirement Type Max Size Possible Values / Example Description Notes
easycart Mandatory integer 1 1 Enables Level III processing mode. Must always be set to 1.
ponumber Mandatory string 17 Example: PO-10001 Purchase order number associated with the transaction. If omitted, the transaction ID will be used automatically.
tax Mandatory decimal 7 Example: 12.50 Total transaction tax amount. Format: 00.00 1
Must be pre-calculated and submitted with the request.
For tax-exempt transactions, set to 00.00.
transflags Mandatory string N/A level3 Enables Level III transaction handling. For tax-exempt transactions, use level3,exempt.

Item-Level Fields

The following item-level fields must be submitted for each purchased item.

Variable Requirement Type Max Size Possible Values / Example Description Notes
item# Mandatory string 10 Example: SKU1001 Item or product identifier. Cannot contain only spaces or zeros.
cost# Mandatory decimal 10 Example: 15.00 Cost of the item. Must be numeric 1234.56 format. 1
Cannot contain only spaces or zeros.
quantity# Mandatory integer 5 Example: 2 Quantity purchased. Cannot contain only spaces or zeros.
description# Mandatory string 79 Example: WidgetA Item description. Spaces, underscores, zeros, parentheses, and dashes are not allowed.
customa# Optional decimal 19 Example: 1.50 Item discount amount. Format: 00.00.
Must be numeric 1234.56 format. 1
customb# Mandatory decimal 19 Example: 0.75 Item tax amount. Format: 00.00.

Cannot contain only spaces or zeros.

For tax-exempt transactions, set to 00.00. 1
customc# Mandatory string 19 Example: 123456 Item commodity code. Cannot contain only spaces or zeros.
unit# Mandatory string 3 Example: PCE Unit of measure code. See Level III Purchase Card - Specification Addendum.

Multiple Item Submission

Repeat the above eight name/value pairs for each item purchased, incrementing the numeric suffix for each additional item.

Example

If two items are purchased, the following fields would be submitted:

item1
cost1
description1
quantity1
customa1
customb1
customc1
unit1

item2
cost2
description2
quantity2
customa2
customb2
customc2
unit2

Tax-Exempt Transactions

For tax-exempt transactions, use the following values:

Variable Required Value Notes
tax 00.00 Transaction-level tax amount. 1
customb# 00.00 Item-level tax amount. 1
transflags level3,exempt Enables tax-exempt Level III processing.

Settlement Validation

The gateway validates Level III transaction totals prior to settlement.

The following calculation must reconcile correctly. The transaction-level tax value must be pre-calculated and included in the request (it is not derived automatically from item-level tax fields):

(quantity × cost) + tax = card-amount

Transactions that fail validation may be rejected or fail settlement processing.

Unit of Measure Codes

The unit# field must contain an approved Level III Unit of Measure code.

See the Level III Purchase Card - Specification Addendum (Item Bulk / Unit of Measure) for the list of possible codes.

Processing Notes

Failure to provide complete or accurate Level III data may result in settlement or interchange qualification issues.

⚠️ Formatting Rule (Applies to All Amount Fields)

  1. All monetary values must be numeric only in the format 1234.56. Do not include currency symbols, commas, or formatting. Exactly two decimal places are required. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎