Transaction Error Generation Data

The table below helps you simulate various error responses by using specific transaction amounts. This allows you to verify how your integration handles different error scenarios before going live.

Note: Codes may vary depending on the API endpoint. Some response codes may also have more than one associated message, as shown below.

Value	HTTP Status Code	HTTP Status Code	Amount
000	200	Approved	0.49, 0.80, 0.81, 0.82
000	200	SUCCESS	0.49, 0.80, 0.81, 0.82
001	400	Could not communicate with Terminal
001	404	Signature not found
002	500	Failed to process batch
002	402	Force Approval
002	400	Validation error
003	402	Declined by Issuer – Card expired	0.29
003	500	Failed to process batch	0.29
003	400	transaction-id required
004	402	Card Expired	0.05, 0.04
005	402	Card Suspended
006	402	Allowable Pin Entries Exceeded	0.40
007	402	Declined by Issuer – Referred – Please call Card Issuer	0.01, 0.02
008	402	Declined by Issuer – Invalid Amount	0.11, 0.32
009	400	Invalid Card Number	0.14
010	402	Declined by Issuer – Account not found	0.36, 0.37, 0.38
011	400	Invalid Request	0.31, 0.35, 0.39
012	402	Not Sufficient Funds	0.21
013	402	Transaction Not Permitted To Cardholder
014	402	Declined by Issuer – Exceeds amount limit	0.23
015	402	Declined by Issuer – Transaction not permitted	0.43, 0.44
016	402	Declined by Issuer – Frequency limit exceeded	0.22, 0.25, 0.71
017	402	Card Not Active
018	400	Invalid Pin	0.12, 0.13, 0.47
019	500	PIN Key sync error – Please call Customer Support
020	400	Invalid Currency
021	402	Declined by Issuer – Invalid card security code	0.48
022	400	Cashback Amount Exceeded	0.16
023	402	Transaction Declined By Issuer	0.04, 0.09, 0.15, 0.17
024	402	Previously Reversed	0.10
025	402	Exceeds Maximum Refundable Amount
026	402	Declined by Issuer – Invalid Card Number
027	402	Original Not Found	0.34
028	402	Invalid Terminal – Please call Customer Support
029	402	Inactive Terminal
030	402	Invalid merchant ID – Please call Customer Support	0.46
031	402	Transaction Did Not Complete Normally, Please Retry	0.03
032	402	Duplicate Transaction	0.54
033	402	Capture Card, Please Call Processor
034	402	Card Lost	0.07
035	402	Card Stolen	0.08
036	200	Advice Accepted
037	200	Advice Accepted, No Action Taken	0.33
038	402	Reconciled, In Balance
039	402	Not Reconciled, Totals Provided
040	402	No Opened Batch
041	400	Field Validation	$0.00
042	401	Unauthorized
043	400	Amount Minimum
044	400	Amount Maximum
045	402	Duplicate Transaction
046	402	Avs Response Not Accepted
047	402	Csc Response Not Accepted
048	402	Csc Response Not Accepted
049	500	No Response From Server
050	500	Internal Error
051	500	Could Not Connect
052	500	Exception Condition Contact Support
053	500	Exception Condition Contact Support
054	402	Data Element Error
055	500	Acquirer Not Supported By Switch
056	402	Transaction Destination Cannot Be Found
057	402	Card Issuer Timed Out
058	402	Card Issuer Unavailable
059	402	Duplicate Transmission
060	500	System Error, Database
061	402	Aborted, Threshold Exceeded
062	500	System misconfiguration: {MAY INCLUDE ADDITIONAL ERROR TEXT}
063	500	System Error, Transaction
064	500	System Error, Hsm
065	500	Configuration Error, Invalid Terminal
066	500	Configuration Error, Invalid Terminal
067	500	Configuration Error, Configuration Error
067	500	Configuration error, invalid merchant
068	500	Configuration Error, Configuration Error
068	500	Configuration error, inactive merchant
069	500	Configuration Error, Configuration Error
069	500	Configuration error, invalid store
070	500	Configuration error, inactive store
070	500	Configuration Error, System Error
071	500	System Error, Other
072	500	System Error Other
073	500	System Error Other
074	400	HPP Generic Error Message; query transaction for error details.
074	400	Invalid Request
074	400	Merchant-id from request does not match merchant-id of initial transaction
081	400	Create entity failed
081	400	Update entity failed
081	500	Update failed
082	400	Add entity failed
082	500	Add failed
082	404	Device not found
082	404	Entity not found
082	500	Get failed
083	400	Get entity failed
083	500	Get failed
083	400	Resource not found
084	500	Add Token To Customer Failed
084	400	Apikey on device does not belong to the terminal you have authenticated. Please check that the device was configured correctly
085	404	Unable to delete setting
085	400	Valid Content-Type Header Required for PUT or POST
086	400	Missing or Invalid Accept Type Header. Accept Type Header must be of type ‘application/json or ‘application/xml
087	400	Metadata can only have a maximum of ten key/value pairs
088	400	No body in request
089	200	Delete Successful
089	500	Error Deleting resource
089	400	Unable to delete Customer token
090	400	Required request body content is missing
090	400	Required request body content is missing, malformed, or datatype usage (ex- boolean, number) is invalid
091	402	Delete Token Failed. Token Associated With Payment Plan
091	204	No batch found to process
091	404	Object not found
091	404	Transaction not found
092	405	Http Method not supported
092	404	URL Parameter Invalid not found
093	400	Customer Delete Failed – Customer has active plans
093	400	Merchant Opt Out Delete Failed
094	400	Cannot delete Plan that has been used to charge the customer
280	400	Transaction failed
281	400	Void failed. Cannot void ach transactions that are returned or settled.
282	400	Authorization failed
283	400	Validation failed
284	400	ACH Account not found
285	400	Cannot process request. Contact Xplor Pay for assistance
286	400	An error occurred we did not account for with Drools rules or otherwise
287	404	Transaction not found
288	400	Request failed
289	400	Provider failed
290	500	Transaction Failed
291	400	Cannot process request. Contact Xplor Pay for assistance
292	404	Transaction not found
293	404	Transaction not found
294	500	Cannot process request. Contact Xplor Pay for assistance
295	500	Cannot process request. Contact Xplor Pay for assistance
880	400	Error parsing request
880	400	Error while submitting request to pax terminal
880	400	Failed to process hpp request.
880	400	Transaction failed
880	500	Unexpected Error – please contact customer support
881	400	Device communications unsupported
881	400	Manufacturer unsupported
882	400	Transaction type unsupported for this manufacturer
883	500	Terminal not connected
884	400	Terminal cannot be determined. Configure from Virtual Terminal Settings
884	400	Terminal cannot be determined. Confirm terminal is configured for Semi-Integrated mode
885	400	Device disabled
886	400	Failed to connect to Gateway. Please check device configuration
886	400	Terminal connection error
887	400	Transaction failed
888	400	Failed to serialize request as xml.
889	400	Token only request failed
889	400	Transaction failed
890	400	Transaction endpoint does not match transaction type
8801	402	Could not determine if transaction succeeded or failed
8831	500	Terminal is busy. Check terminal and try again
13005	400	Signature not valid for HPP response