Defines standard Smart Screens v2 transaction response fields and processing status values.
Transaction Response
Response Fields
The transaction response includes all submitted name/value pairs, along with the response fields listed below.
| Variable | Max Size | Possible Values / Example | Description | Notes |
|---|---|---|---|---|
pi_response_status |
7 | success, badcard, problem, fraud |
Indicates the final transaction processing status. | success = transaction approved, badcard = declined by processor, problem = processing or communication issue, fraud = rejected by FraudTrak2 filter settings. |
pi_duplicate_transaction |
3 | yes |
Indicates the submitted transaction was previously processed using the same order ID. | When present, response values will match the original transaction response. |
pi_error_message |
N/A | — | Error response message returned during transaction processing. | Returned only when applicable. |
pt_order_id |
25 | Example: 123456789 |
Unique order identifier assigned to the transaction. | Used for future transaction actions including voids and returns. |
pi_response_code |
N/A | — | Alphanumeric transaction response code. | See Appendix documentation for response code definitions. |
pt_authorization_code |
6 | Example: A1B2C3 |
Authorization code returned by the processor. | Present on approved authorizations when available. |
pt_ip_address |
15 | 123.123.123.123 |
IP address of the posting system or client. | Used for logging and fraud analysis. |
pt_user_agent |
N/A | Example: Mozilla/5.0 |
Browser or client identifier of the posting system. | Used for device and client identification. |
pt_transaction_response_hash |
N/A | — | Verification hash returned with the transaction response. | Used to validate response authenticity and integrity. |
Notes
The fields above assume the standard response values returned by the Smart Screens v2 payment method.