Defines transaction amount related parameters for Remote API processing.

Transaction Amount

Use the fields below to define transaction totals, itemized purchase information, reporting data, fraud screening details, and custom transaction metadata.

Variable Requirement Type Max Size Possible Values / Example Description Notes
currency Optional string 3 USD, EUR, CAD ISO 3-character currency code used for the transaction. Defaults to USD if omitted. Must match your merchant account configuration.
tax Optional decimal 7 10.25 Sales tax amount applied to the transaction. 1 Format should be 00.00.
shipping Optional decimal 7 15.00 Shipping charge amount applied to the transaction. 1 Format should be 00.00.
handling Optional decimal 7 15.00 Handling charge amount applied to the transaction. 1 Format should be 00.00.
card-amount Mandatory decimal 10 1234.56 Total transaction amount to be charged. 1 Format must be 1234.56.
gratuity Optional decimal 10 25.00 Gratuity or tip amount associated with the transaction. 1 Applicable only when authtype=authpostauth.

⚠️ 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. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎