Response codes - Tesouro

Authorizations

Upon submitting an authorization request to Tesouro, you’ll receive a response containing a five-character processorResponseCode and message indicating whether the request was approved or declined by the network, or if it failed to reach the network due to an error. Tesouro will also provide advice on what, if anything, can be done to successfully retry a declined or failed request. The response codes are grouped using a letter and number prefix:

Grouping	Response type	Description
`A0xxx`	Approval	The request was successful.
`D1xxx`	Decline	The request was declined, though subsequent attempts may be successful.
`E1xxx`	Error	The request failed before being sent to the Network.

A0xxx - Approvals

Response code	Response message
`A0000`	Full amount approved
`A0001`	Partial amount approved
`A0002`	Purchase amount approved

D1xxx - Declines

Response code	Response message	Description
`D1001`	Call issuer	Call the issuer to get the transaction manually approved.
`D1002`	Invalid account number	Ask the customer for a new method of payment.
`D1003`	Stolen or lost card	Ask the customer for a new method of payment. Take extra precautions as the transaction may be fraudulent.
`D1004`	Frozen account	Ask the customer for a new method of payment.
`D1005`	Generic decline	Attempt the transaction again after waiting a day or more or ask the customer for a new method of payment.
`D1006`	Insufficient funds	Attempt the transaction again after waiting several days or ask customer for a new method of payment.
`D1007`	Expired card	Ask cardholder for updated expiration date. If accurate ask for new method of payment.
`D1008`	Stand alone refund not allowed.	Ask for another method of payment to process the refund.
`D1009`	Possible fraud	Attempt the transaction again after a day or more or ask the customer for a new method of payment. Take extra precautions as the transaction may be fraudulent.
`D1010`	Maximum attempts exceeded	Ask the customer for a new method of payment.
`D1012`	Network reported system error	Attempt the transaction again after waiting several minutes. If error persists contact Tesouro.
`D1013`	Cardholder could not be authenticated	Ask the customer for a new method of payment. Take extra precautions as the transaction may be fraudulent.
`D1014`	Cardholder authentication required	Utilize cardholder authentication (3DS) or ask customer for another method of payment.
`D1016`	Issuer unavailable	Attempt the transaction again after waiting several minutes or ask customer for another method of payment.
`D1019`	Pickup card	If possible confiscate the card. Ask customer for a new method of payment. Take extra precautions as the transaction may be fraudulent.
`D1020`	Invalid issuer	Ask the customer to double check the account number. If accurate ask for a new method of payment. Take extra precautions as the transaction may be fraudulent.
`D1021`	Transaction not permitted	Ask the customer for a new method of payment.
`D1022`	Restricted card	Ask the customer for a new method of payment.
`D1023`	Illegal transaction	Ask the customer for a new method of payment.
`D1024`	Retry transaction	Attempt the transaction again after waiting several minutes.
`D1025`	Reversal Failed	Retry the request at a later time.
`D1026`	No account	Ask the customer for a new method of payment.
`D1027`	Invalid PIN	Ask the customer to reenter PIN. If fails again ask for new method of payment. Take extra precautions as the transaction may be fraudulent.
`D1028`	Exceeds withdrawal amount limit	Ask the customer for a new method of payment. Take extra precautions as the transaction may be fraudulent.
`D1029`	Exceeds withdrawal frequency limit	Ask the customer for a new method of payment. Take extra precautions as the transaction may be fraudulent.
`D1030`	Response received late	Transaction failed. Process a new transaction.
`D1031`	Chip failure	Fallback to magstripe or key entered or ask for new method of payment. Take extra precautions as the transaction may be fraudulent.
`D1032`	Reconciliation error	Terminal out of balance. Contact Tesouro.
`D1034`	System unavailable	Attempt the transaction again after waiting several minutes. If error persists contact Tesouro.
`D1035`	Customer cancellation	Do not process future transactions.
`D1036`	Multi-currency DCC failure	Process transaction without DCC.
`D1037`	Multi-currency invert failure	Process transaction without multi-currency.
`D1038`	DCC complete	no auth performed, SoftDecline, Re-auth the transaction.
`D1039`	Preferred debit routing denial	Reprocess the transaction using the debit network.
`D1040`	Stop payment order	Do not process future transactions.
`D1041`	Revocation of auth order	Do not process future transactions.
`D1042`	Revocation of all auth orders	Do not process future transactions.

E1xxx - Errors

Requests that fail before being sent to the payment network will provide an error response code containing detail about what caused the error and how, if possible, to correct it.

Response code	Response message	Description
`E1001`	System error	Call Tesouro
`E1002`	Network timeout	Retry the request at a later time.
`E1003`	Request field failed validation	Review the error response for details and guidance on how to resolve.
`E1004`	Acceptor not found	Review the error response for details, then update the request with the correct acceptor ID.
`E1005`	Referenced payment not found	Review the error response for details, then update the request with the correct referenced payment.
`E1006`	Could not parse network response	Retry the request at a later time.
`E1007`	Token not found	Review the error response for details, then update the request with the correct token.
`E1008`	Payment network not configured	A payment network was not associated with the cardholder’s account number.
`E1009`	Rule violation	The transaction request did not pass a Tesouro pre-check rule. Check the explanation and advice fields in the graphQL response for more detail on which rule was violated, and if applicable, next steps you can take.
`E1010`	Invalid token	The token supplied is associated with a different payment method that what was expected. e.g., If a tokenized credit card is passed on transaction expecting a tokenized bank account.

Account updater

U3xxx - Updater responses

Response code	Response message
`U3000`	Accepted
`U3001`	No updates found
`U3002`	Change in account number
`U3003`	Change in expiration date
`U3004`	Closed account
`U3005`	Contact cardholder
`U3006`	Non-participating issuing bank

Downloads

ISO to Tesouro response code mappings (csv)

​Authorizations

​A0xxx - Approvals

​D1xxx - Declines

​E1xxx - Errors

​Account updater

​U3xxx - Updater responses

​Downloads