Simple Order API

item_#_unitPrice

Per-item price of the product.
This is an item-level field.
This value cannot be negative. You can include a decimal point (.), but you cannot include any other special characters. The amount is truncated to the correct number of decimal places.
This field is available only on the
American Express Direct
,
Barclays
,
Chase Paymentech Solutions
,
Elavon Americas
,
FDC Compass
,
FDC Nashville Global
,
FDMS Nashville
,
FDMS South
,
GPN
,
OmniPay Direct
,
RBS WorldPay Atlanta
,
TSYS Acquiring Solutions
,
Visa Platform Connect
, and
Worldpay VAP
processors.
Some processors have specific requirements and limitations, such as maximum amounts and maximum field lengths.
Barclays
Value must be numeric with two exponents.
Visa Platform Connect
Limit authorization and capture amounts to 999999999999 (twelve 9s).
DCC with a Third-Party Provider
: Set this field to the converted amount that was returned by the DCC provider. You must include either this field or
purchaseTotals_grandTotalAmount
in a request.
Zero Amount Authorizations
: If your processor supports zero amount authorizations, you can set this field to
0
for an authorization to find out whether the card is lost or stolen.
Level III transaction
: This value cannot be zero (0).

Specifications

  • Data Type:
    String
  • Data Length
    • American Express Direct
      : 8 (CAD), 10 (USD)
    • Barclays
      : 8 (for Mastercard), 18 (for Visa)
    • Chase Paymentech Solutions
      : 13 (USD)
    • FDC Compass
      : 13 (USD)
    • FDC Nashville Global
      : 13 (USD)
    • FDMS Nashville
      : 15 (USD)
    • RBS WorldPay Atlanta
      : 8 (Mastercard), 10 (Visa)
    • Other processors: 12

Mapping Information

  • REST API Field:
    orderInformation.lineItems[].unitPrice
  • SCMP API Field:
    amount
  • Simple Order API Field:
    item_#_unitPrice

Processor Field Names

This list provides the Level II/Level III processor field name for each processor that supports Level II or Level III data.
  • American Express Direct
    : Does not apply
  • Barclays
    : Unit Price
  • Chase Paymentech Solutions
    : Unit Cost
  • Elavon Americas
    : Unit Cost
  • FDC Compass
    : Unit Cost
  • FDC Nashville Global
    : Item Unit Cost
  • FDMS Nashville
    : Does not apply
  • FDMS South
    : Does not apply
  • GPN
    : Unit Price
  • OmniPay Direct
    : Unit Cost/Unit Price
  • RBS WorldPay Atlanta
    : Unit Cost
  • TSYS Acquiring Solutions
    : Unit Cost
  • Visa Platform Connect
    : unitPrice
  • Worldpay VAP
    : unitCost