A reauth is a request to settle a transaction at a lower dollar amount than the original authorization. This same functionality can be performed by performing a mark for a dollar amount less than the original auth amount.

Transaction Administration - Auth Reversal

Overview

The Auth Reversal operation is used to adjust a previously authorized transaction to a lower amount prior to settlement. This allows partial reduction of an authorization amount while maintaining the original transaction reference.

Request Parameters

Variable Requirement Type Max Size Possible Values / Example Description Notes
publisher-name Mandatory string N/A Example: gatewayuser Gateway account username issued to you.
publisher-password Mandatory string N/A Example: securepassword Remote Client Password used for API authentication. This differs from the login password for the admin portal.
mode Mandatory string N/A reauth Defines the operation type for auth reversal processing. Must be set to reauth.
orderID Mandatory string 20 Example: 1234567890 Original transaction identifier being modified. Must reference a valid prior authorization.
card-amount Mandatory decimal 10 1234.56 New authorization amount to be set. 1 Cannot exceed the original authorized amount.
reauthtype Optional string N/A authonly Controls whether a post-authorization settlement is created. If set to authonly, no postauth will be created upon success.
notify-email Optional string 39 user@example.com Email address used for transaction failure or alert notifications.

Response Parameters

Variable Value Description Notes
FinalStatus success, problem, pending Indicates overall transaction result. Some processors may return pending before final completion.
success yes, no Indicates whether the request was successful. Reflects immediate processing outcome.
aux-msg string Informational message returned upon success. Example: transaction marked for settlement.
MErrMsg string Error message returned when the request fails. Example: transaction not marked successfully.
Duplicate yes, blank Indicates whether the orderID was previously submitted. If yes, the original transaction data is returned without reprocessing.

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