Defines response fields and transaction handling behavior for authorization processing through the Remote API.
Transaction Response
Overview
The authorization response includes all submitted name/value pairs along with additional fields returned by the gateway. Responses are returned as a URL-encoded string for parsing.
Response Format
The system returns transaction results in the following format:
name1=value1,name2=value2,name3=value3
All original request parameters are included in the response, along with the fields listed below.
Response Fields
| Variable | Max Size | Possible Values / Example | Description | Notes |
|---|---|---|---|---|
FinalStatus |
N/A | success, badcard, problem, fraud |
Final transaction status returned after processing. | success = approved, badcard = processor decline, problem = non-card issue, fraud = blocked by fraud screening. |
Mstatus |
N/A | Deprecated | Legacy status field. | Superseded by FinalStatus. |
success |
N/A | Deprecated | Legacy success indicator. | Superseded by FinalStatus. |
avs-code |
N/A | Y |
Address Verification System response code. | Refer to AVS reference table for definitions. |
cvvresp |
N/A | M |
CVV/CVV2 verification response. | Used for card security validation. |
resp-code |
N/A | 00 |
Processor response code. | See processor response code documentation. |
auth-code |
6 | A1B2C3 |
Authorization code issued by processor. | Returned on successful approvals when available. |
MErrMsg |
N/A | — | Error message returned by processor. | Present only when an error occurs. |
Errdetails |
N/A | card-number=invalid|email=missing |
Detailed validation or fraud error output. | Requires FraudTrack2. Pipe-delimited format. |
aux-msg |
N/A | — | Additional processor message. | Supplemental informational output. |
orderID |
25 | 123456789 |
Unique transaction identifier. | Used for downstream actions such as voids and refunds. |
user-agent |
N/A | Mozilla/5.0 |
Client or browser identifier. | Used for logging and tracking purposes. |
ipaddress |
15 | 123.123.123.123 |
IP address of submitting system or customer. | Used for fraud analysis and audit trails. |
Duplicate |
3 | yes |
Indicates duplicate orderID submission. |
Returned values match original transaction. |
sresp |
1 | A, C, D, P, X, E |
Simplified response status code. | A approved, C call auth center, D declined, P pick up card, X expired, E error. |