On This Page
REST API

orderInformation. amountDetails.totalAmount

Grand total for the order.
If your request includes line items, do not include this field in your request.
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.
IMPORTANT
Some processors have specific requirements and limitations, such as maximum amounts and maximum field lengths.
Dynamic Currency Conversions
When this field is used in a request with Dynamic Currency Conversion, this field value must be denominated in the customer's billing currency.
Original Credit Transactions (OCT)
The amount must be less than or equal to 50,000 USD. Amount limits differ depending on limitations imposed by your acquirer in addition to local laws and regulations. For more information, contact your acquirer.
PIN Debit Transactions
If the transaction includes a cashback amount, that amount must be included in this total amount. If the transaction includes a surcharge amount, that amount must be included in this total amount.
Zero Amount Authorizations
If your processor supports zero amount authorizations, you can set this field to
0
 for the authorization to verify whether the card is lost or stolen.

Specifications

  • Data Type:
     String
  • Data Length
    • Comercio Latino
      : 19
    • Other Processors: 15 (for e-check transactions), 17 (for all other transactions)

Mapping Information

  • REST API Field:
    orderInformation.amountDetails.totalAmount
  • SCMP API Fields:
    • auth_request_amount
    • bill_bill_amount
    • ecp_credit_total_amount
    • ecp_debit_total_amount
    • oct_amount
    • pin_debit_purchase_request_amount
    • tax_total_grand
  • Simple Order API Fields:
    • ccAuthReply_requestAmount
    • ccCaptureReply_amount
    • ecCreditReply_amount
    • ecDebitReply_amount
    • octReply_amount
    • pinDebitPurchaseReply_requestAmount
    • purchaseTotals_grandTotalAmount
    • taxReply_grandTotalAmount
    On
    Barclays
     and
    Comercio Latino
    , only the
    purchaseTotals_grandTotalAmount
     field is supported for authorizations.

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.
  • Barclays
    : Line Item Total
  • Chase Paymentech Solutions
    : Does not apply
  • FDC Compass
    : Does not apply
  • FDC Nashville Global
    : Does not apply
  • OmniPay Direct
    : Line Item Total
  • RBS WorldPay Atlanta
    : Amount
  • TSYS Acquiring Solutions
    : Does not apply