Response codes

Categories

CodeCategory
0XXXSuccess
1YXXPayment solutions
2XXXCommunication errors or payment solution internal server error
3XXXAddon Payments internal errors: Database, servers, communications
5XXXAddon Payments settings errors: Firewall, workflow, wrong requests
8XXXServices/3DS
666Merchant disabled

List of response/error codes

Below is a table with all the response codes or error codes and their description. These codes belong in general to Addon Payments and in particular to the card payment solution.

< code > AP response codeAP message< paymentCode > Card response code< paymentMessage >Payment solution message
0000Success
1501Function not available for this account
1502Insufficient funds116Insufficient funds available
1503The amount has been reimbursed already
1504The merchant’s IP address isn’t on the whitelist for the payment method
1505The amount entered for this operation is not correct. Please check the response from the payment method110Incorrect amount. The transaction total is unusual for the type of merchant requesting payment authorization
1505The amount entered for this operation is not correct. Please check the response from the payment method193Amount exceeded (reserved)
1505The amount entered for this operation is not correct. Please check the response from the payment method916Amount too small
1506The username and/or password used on the API call are incorrect
1507Unknown error by payment method
1508A parameter in the payment call is not valid. Check the response from the payment method
1509The transaction could not be processed. Check the response from the payment method109Merchant or terminal ID not valid
1509The transaction could not be processed. Check the response from the payment method120Operation declined by SIS
1509The transaction could not be processed. Check the response from the payment method122Declined for VCA checks
1509The transaction could not be processed. Check the response from the payment method123Wrong CAUV
1509The transaction could not be processed. Check the response from the payment method185Check devices not EMV compatible
1509The transaction could not be processed. Check the response from the payment method187EMV cryptography error
1509The transaction could not be processed. Check the response from the payment method192Case data not found (reserved)
1509The transaction could not be processed. Check the response from the payment method194Rejected by phone operator
1509The transaction could not be processed. Check the response from the payment method198DCC declined to send rates
1509The transaction could not be processed. Check the response from the payment method210Hold for VCA checks
1509The transaction could not be processed. Check the response from the payment method480Original operation not found or timeout exceeded
1509The transaction could not be processed. Check the response from the payment method503Original operation not found or timeout exceeded
1509The transaction could not be processed. Check the response from the payment method904Merchant not registered in FUC
1509The transaction could not be processed. Check the response from the payment method909System error
1509The transaction could not be processed. Check the response from the payment method913Duplicate transmission
1509The transaction could not be processed. Check the response from the payment method940Transaction voided previously
1509The transaction could not be processed. Check the response from the payment method941Authorization transaction already voided by a previous void
1509The transaction could not be processed. Check the response from the payment method942Original authorization transaction declined
1509The transaction could not be processed. Check the response from the payment method943Data for original transaction doesn’t match
1509The transaction could not be processed. Check the response from the payment method944Wrong session
1509The transaction could not be processed. Check the response from the payment method945Duplicate transmission
1509The transaction could not be processed. Check the response from the payment method946Void operation in progress
1509The transaction could not be processed. Check the response from the payment method947Duplicate transmission in progress
1509The transaction could not be processed. Check the response from the payment method948Local date and time not in synch
1509The transaction could not be processed. Check the response from the payment method949Terminal not operational
1509The transaction could not be processed. Check the response from the payment method965Rule violation
1510ransaction blocked by the payment method
1511The reimbursement could not be processed. Check the response from the payment method950Refund not allowed
1512The order ID does not exist
1513The operation could not be processed. Please check the response from the payment method204Operation not allowed
1514Problem with the URL. Check the response from the payment method
1515Invalid http(s) address. Check the response from the payment method
1516The end user who requested the withdrawal is blocked
1517This UUID has already been used
1520API request not compatible. You are not registered to use this API
1521Account closed
1522Your merchant account is currently not active
1523Your merchant account doesn’t accept this currency
1524The transaction reference provided has already been used for another transaction. You must provide a unique value for each request
1525The amount must be numerical and may not contain decimals or alphabetical characters
1526The account ID or email address provided is not valid
1527The verification code provided is not valid for this request
1528The customer ID provided is not valid
1529The member is a resident of a country/state/region that has been blocked by the merchant
1530The member is a resident of a country/state/region that has been blocked by the payment method
1531The member is not allowed to receive this type of transaction
1532The merchant is not allowed to initiate this type of transaction
1533Insufficient funds to complete the transaction
1534The amount entered is under the limit established for transfers
1535The amount entered is over the limit established for transfers
1536The amount entered is under your established limit for transfers
1537The amount entered is over your established limit for transfers
1538The amount entered is too small. You must enter an amount greater than or equal to 1 unit of the currency
1539The amount entered is too large. You must enter an amount within your transaction limits
1540The transaction exceeds the allowed limit for the account
1541The transaction wasn’t completed within the time allowed and has expired
1542The transaction was cancelled or declined manually by the merchant
1543The transaction you are trying to recover was submitted using the old NetDirect or Instant Payout API
1544The planId requested has already been used. Please enter a unique planId with your request
1545You can’t delete a subscription plan you’ve already subscribed to
1546The length of this subscription plan is not valid
1547The email address provided is already registered with the payment solution
1548The third-party processor declined the transaction
1549The payment solution declined to process the transaction
1550Your request was not authorized because the API requires member authorization
1551he API is not currently available due to maintenance
1552Transaction not found in the payment solution system
1600Payment solution error. General entry error. Please check the payment solution response
1601Function not available for this account
1602Insufficient funds
1603The amount has been reimbursed already
1604The merchant’s IP address isn’t on the whitelist for the payment method
1605The amount entered for this operation is not correct. Check response from the payment solution
1606The username and/or password used on the API call are incorrect
1607Unknown error by payment method
1608A parameter in the payment call is not valid. Check response from the payment solution
1609Withdrawal could not be processed. Check response from the payment solution
1610A parameter in the payment call is not valid. Check response from the payment solution
1611The reimbursement could not be processed. Check response from the payment solution
1612Orderid does not exist
1613The operation could not be processed. Check response from the payment solution
1614Problem with the URL. Check response from the payment solution
1615HTTP (s) address not valid. Check response from the payment solution
1616Incorrect CVV129Wrong CVV2
1616Incorrect CVV280Wrong CVV2
1617Payment stopped by the card scheme
1618Card declined. Please check the payment solution response101Card expired
1618Card declined. Please check the payment solution response114Card doesn’t support operation type
1618Card declined. Please check the payment solution response118Card not registered
1618Card declined. Please check the payment solution response125Card not effective
1618Card declined. Please check the payment solution response180Card doesn’t belong to the service or not compatible
1618Card declined. Please check the payment solution response201Card expired
1619Not authorized. Check response from the payment solution
1620Card number not valid. Please check the payment solution response
1621Card expired. Please try again with another card
1622Payment stopped by the solution
1623Verification process failed
1624Account deactivated
1625Check the limit on the card121Exceeds the allowed limit for the card
16263D information not valid. Please check the payment solution response
1627Error in fraud verifications. Please check the payment solution response167Fraud suspected
1628Potential fraud. Transaction declined
1629MPI error. Please check the payment solution response
1630Country or BIN ranged blocked. Please check your settings
1631Token error. Please check the payment solution response
1632Unknown payment solution error
1633Success
1634Transaction pending processing by payment solution
1635Descriptor not valid. Please check the payment solution response
1636Email not valid. Check response from the payment solution
1637Phone number not valid. Check response from the payment solution
1638Issuer declined transaction. Please check the response from the payment method107Contact issuer. The issuing bank doesn’t allow automatic authorization
1638Issuer declined transaction. Please check the response from the payment method119Declined by issuer without explanation
1638Issuer declined transaction. Please check the response from the payment method172Declined, do not repeat
1638Issuer declined transaction. Please check the response from the payment method173Declined, do not repeat without updating card details
1638Issuer declined transaction. Please check the response from the payment method174Declined, do not repeat within 72 hours
1638Issuer declined transaction. Please check the response from the payment method190Declined by issuer without explanation
1638Issuer declined transaction. Please check the response from the payment method207Contact issuer
1638Issuer declined transaction. Please check the response from the payment method290Declined by issuer without explanation
1639Required information missing. Please check the payment solution response
1640Error in original transaction ID linked to transaction error. Please check the response from the payment method
1641Card or currency not accepted. Please check the payment solution response104Operation not allowed for this type of card
1642Null error. Please check the payment solution response
1643Timeout. Please check the payment solution response928Timeout exceeded
1646Merchant not valid
1647Issuer not available912Issuer not available
1648Issuer not valid
1649RE ENTRAR TRAN
1650Wrong format
1651Card lost208Card lost
1652Card stolen209Card stolen
1653Over limit
1654Card restricted102Card suspected of fraud or blocked temporarily
1654Card restricted181Restrictions on card
1654Card restricted182Restrictions on card
1654Card restricted183Restrictions on card
1654Card restricted196Card on blacklist
1654Card restricted202Card suspected of fraud
1655Transaction not allowed
1656Over limit
1657Purchase only
1658Cannot be authenticated
1659Duplicate transaction
1660System error
1661Cash not allowed
1662Payment stopped
1663Card schemes not supported
1664Expiry date not valid191Wrong expiry date
1665Currency not valid
1666Only numbers allowed
1667Transaction not valid
1668Violates payment solution rules. Please check the response from the payment method
1669Problem with 3-D Secure
16703-D Secure authentication failed1843DSecure authentication error by cardholder
1671Backend issue
1672Declined by issuer or card scheme
1673Card restricted
1674Card lost or stolen
1675Fraud suspected
1676Payment solution error. Please check the payment solution response
1677Your merchant account is currently not active
1678Expiry date not valid
1679Card account does not exist
1680The transaction wasn’t completed within the time allowed and has expired
1681File error. Check response from the payment solution
1682Pin error. Check response from the payment solution106Exceeded number of wrong PIN attempts
1682Pin error. Check response from the payment solution112PIN required
1682Pin error. Check response from the payment solution117Incorrect PIN
1682Pin error. Check response from the payment solution126Blocked, PIN not valid
1682Pin error. Check response from the payment solution206Exceeded number of wrong PIN attempts. Hold card
1683Transaction already reversed
16843DS operation not assured on 3DS and response from 3DS server did not assure the transaction
1690No customer request for this transaction
1691No online request for this transaction
1692No payment details provided
1693No transaction found when creating payment request
1694Customer email is required for P24
1695
Customer email, IBAN and BIC are required for SEPA payment
1696Customer email, ID, national ID and date of birth are required for Boleto Bancario, Pago Fácil and Rapipago
1697Date of birth not provided for Boleto Bancario, Pago Fácil and Rapipago
1698Repeat the operation
2000General communication error
2001Timeout communication erro
2002Unauthorized communication error
2003Response from the payment solution not supported
3000Internal server error
3001Error loading paysol settings
3002Card number not provided to get BIN details
3003Encryption error
3004Domain error
3005XML Error analysing an object
3006JSON Error analysing an object
3007BackOffice error
3008Error loading the transaction
3009Object not found in database (merchant, product, etc.)
3010Problem accessing database
3011Cannot send email
30123Secure result parameters not found
30133Secure result parameters not correct
3014File not found
3015Frictionless request not received. Symbol not valid
3016Frictionless request not received. Time expired
3099N/A
3099Unidentified error
3100Response code not established
5000Internal server error
5001Transaction blocked because this account is deactivated
5002Transaction blocked because the currency, country or amount are not allowed with these settings
5003Transaction blocked because no new cards can be added; limit on number of cards exceeded
5004Transaction blocked because this card has been blocked by the merchant
5005Transaction blocked because this card is already associated with another customer account
5006No payment solution to reimburse with
5007The payment solution does not allow partial reimbursement
5008The transaction status is not pending
5009This operation is not available
5010Attempt to execute credit cards pending accreditation without sending card details or token
5011No previous successful transactions with this token
5012No account associated with this transaction
5013Dates not valid. FROM date must go before TO date
5014Date range not valid. Must be less than one month
5015Date format not valid. Use: YYYY/MM/DD hh:mm:ss
5016Settings not available for the merchant
5017Error in analysing date of birth. Use: DD-MM-YYYY
5018Date format not valid. Use: DD-MM-YYYY
5019Date of birth is required
5020Merchant ID or key/password not valid
5021The set of rules entered is not in the system
5022Error in the workflow process due to a problem with the rules, request or response
5023Cannot process one step in the workflow
5024Serialization error in the workflow process
5025No operation available to execute the workflow
5026Unexpected error in creating links in the workflow
5027Cannot restore a workflow that wasn’t saved
5028Unexpected fundamental change found when checking changes
5029Type not supported for the operation
5030More than one workflow found with the same title or ID
5031Parameter format not valid
5032Module ID not found for the module
5033IP not valid
5034Corrupt data flow found. No valid data found
5035The value of the rule is not valid for the base operation BETWEEN, Syntax: ValueA~ValueB for the range
5036Page or page entries requested are not valid
5037A parameter in the request is required
5038The expiry date for the credit card can’t be blank
5039Workflow not valid
5040Paysol request not valid
5041The status of the original transaction to reimburse is not Success
5042The payment solution is not available
5043The deferred wallet operation could not be executed
5044The transaction was blocked because the customer has been blocked by the merchant
5045The transaction amount doesn’t match
5046Customer account is duplicate. Use the existing one
5047No previous successful transactions for this payment
5497Transaction not reducible
5498Transaction not voidable
5499Transaction cannot be captured
5500Incorrect CVV
5501Card scheme not valid
5502Card expired
5503Card number not valid
5504Amount to reimburse exceeded
5505Amount/currency/country/paysol not available. Please check the Account Manager section
5506Cannot find secondary transaction
5507Cannot find merchant transaction ID
5508Cannot find transaction operations
5509The merchant transaction ID format is not valid
8000Authentication successfulnsY1Authentication successful
8001Success but not completed. Check service response
80023DS REQUESTRADO DE PREVENTA DE RESENITACIÓN
8003Authentication not completed. Check service response
8004SCA authentication required but not requested by the 3DS requestor
8005Cancelled by cardholder
8006Cancelled by requestor
8007Card authentication failed
8008Cardholder not registered
8009Time expired. Check service response
8010Challenge requirednsC2Requires cardholder challenge
8011Not valid/not compatible or transactions not allowed. Check service response
8012Device error. Check service response
8013Exceeds limits. Check service response
8014Card expired
8015Card number not valid
8016Card not registered
8017Card stolen
8018Fraud suspected
8019Security failure
8020Service system error. Check service response
8021Trust low
8022Trust medium
8023Trust high
8024Trust very high
8025Connection error. Check service response
8026Certificate error. Check service response
8027Server error. Check service response
8028HTTP error. Check service response
8029TCP/IP error. Check service response
8030Unknown error. Check service response
8031Certificate not found
8032Authentication error
8033Authentication complete – Attems (merchant secured – cardholder not secured)
8034Authentication complete – payment not guaranteed
8100Requires frictionless
8101Success but not completed. Check service responsensA4Not authenticated, but a test has been generated to attempt authentication in AuthenticationValue
81023DS REQUESTRADO DE PREVENTA DE RESENITACIÓN
8103Authentication not completed. Check service responsensN3Not authenticated
8103Authentication not completed. Check service responsensR6Not authenticated because issuer declined it
8103Authentication not completed. Check service responsensU5Not authenticated for technical or other reasons
8104Authentication successfulnsCY1Authentication successful
8100Requires frictionless
8110Challenge requirednsC2Requires cardholder challenge
8111Cardholder not registered 3DSV2
8112ATSD calculation failed
8888Soft Decline195Control fallback

In the XML notification, you will get several response/error codes indicating the status of the transaction.

In this example, we’ve highlighted the lines where you will find them. In this case, the operation was declined, as you can see in the codes in lines 69, 68, 75 and 76. 

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="3">
	<message>WorkFlow has finished successfully, for transaction Id: 7733721</message>
	<operations>
		<operation sorted-order="1">
			<amount>1.00</amount>
			<currency>EUR</currency>
			<merchantTransactionId>77420696</merchantTransactionId>
			<message>Exemptions has been removed</message>
			<operationType>DEBIT</operationType>
			<service>TRA</service>
			<status>SUCCESS</status>
			<transactionId>7733721</transactionId>
			<respCode>
				<code>0000</code>
				<message>Successful</message>
				<uuid>461218f4_3c18_4dbb_98bf_df7db348d863</uuid>
			</respCode>
		</operation>
		<operation sorted-order="2">
			<amount>1.00</amount>
			<currency>EUR</currency>
			<merchantTransactionId>77420696</merchantTransactionId>
			<message>3dsv2 - processed</message>
			<operationType>DEBIT</operationType>
			<paymentDetails>
				<extraDetails/>
			</paymentDetails>
			<service>3DSv2</service>
			<status>SUCCESS3DS</status>
			<transactionId>7733721</transactionId>
			<respCode>
				<code>8000</code>
				<message>Successful authentication</message>
				<uuid>620a9f5c_2699_4c66_8447_cb000bb33a6b</uuid>
			</respCode>
			<mpi>
				<acsTransID>2c73c511-8d60-4b09-9114-ff00d31c3454</acsTransID>
				<authMethod>01</authMethod>
				<authTimestamp>202311201601</authTimestamp>
				<authenticationStatus>Y</authenticationStatus>
				<cavv>AJkBB4OBmVFmgYFYFIGZAAAAAAA=</cavv>
				<eci>05</eci>
				<messageVersion>2.2.0</messageVersion>
				<threeDSSessionData>ODc3OGE5NDgtZTkwMS00MWExLWE3MjctOTE3OTBhNzFhY2Ux</threeDSSessionData>
				<threeDSv2Token>8778a948-e901-41a1-a727-91790a71ace1</threeDSv2Token>
			</mpi>
			<paymentCode>nsY1</paymentCode>
			<paymentMessage>Authenticated successfully</paymentMessage>
		</operation>
		<operation sorted-order="3">
			<amount>1.00</amount>
			<currency>EUR</currency>
			<details>{"resultCode":"21190","resultDescription":"Denied for some reasons.","values":{"OperationResult":"190"},"threeDsProtocolVersion":"2.2.0"}</details>
			<merchantTransactionId>77420696</merchantTransactionId>
			<message>Denied 'Settle' operation with code: 190 message: Denegación del emisor sin especificar motivo</message>
			<operationType>DEBIT</operationType>
			<optionalTransactionParams/>
			<paymentDetails>
				<cardHolderName>PRUEBA RECHAZO</cardHolderName>
				<extraDetails/>
			</paymentDetails>
			<paymentMethod>19900</paymentMethod>
			<paymentSolution>caixapucpuce</paymentSolution>
			<status>ERROR</status>
			<transactionId>7733721</transactionId>
			<respCode>
				<code>1638</code>
				<message>Issuer declined the transaction, please check payment solution respond</message>
				<uuid>4d9997c1_44eb_4847_b03b_87c2a75b40b6</uuid>
			</respCode>
			<mpi>
				<eci>05</eci>
			</mpi>
			<paymentCode>190</paymentCode>
			<paymentMessage>Denegación del emisor sin especificar motivo</paymentMessage>
		</operation>
	</operations>
	<optionalTransactionParams/>
	<status>SUCCESS</status>
	<workFlowResponse>
		<id>31380</id>
		<name>debit creditcards (TRA)</name>
		<version>0</version>
	</workFlowResponse>
</response>

TRA response codes

Addon Payments response codeAddon Payments message
8200
Transaction blocked
8201Apply exemption
8202Force challenge
8203Requires frictionless
8204Unknown action received from TRA
8205Error communicating with TRA

Response Additional Data (RAD)

The following table of codes for Response Additional Data (RAD) lists the responses available for the Descriptive Data Element of the authorization request message. The following conditions also apply:

  • In character positions 1 to 4, only the following values are valid: 0, 1, 2, 4 or 8. 
  • A “0” in any character position indicates that there is no additional information and/or that the information received hasn’t been checked.
  • If the authorizing institution is unknown, character 4 will be “0” and we assume the card issuer is the authorizer.
  • These data elements must be processed under a separate agreement between the merchant and the acquirer.

The following table shows the Response Additional Data codes:

TypeCharacteristic8421
First position CSC/CSVUnverifiedX
MatchesX
Doesn’t matchX
ReservedX
Second position PostcodeUnverifiedX
MatchesX
Doesn’t matchX
Partial matchX
Third position Address numberUnverifiedX
MatchesX
Doesn’t matchX
Partial matchX

Response Additional Data in the response

As part of our requirements, we return the RAD code in the response. So, Addon Payments must take the following actions:

  • In the operation tag, Addon Payments will include the following fields:
    • rad: Response Additional Data Code (6 digits).
    • radMessage: Response Additional Data message.
  • For Barclays, AIB, WorldPay, etc; the RAD code must be in the operation tag.

Possible values

The following table shows the possible values and meanings of all the possible RAD response codes and radMessage:

RAD codeRad message
000XXXUnknown
001XXXUnverified address
002XXXOnly address matches
004XXXAddress failure
010XXXUnverified postcode
011XXXUnverified postcode and address
012XXXOnly address matches
014XXXAddress failure
020XXXOnly postcode matches
021XXXOnly postcode matches
022XXXPostcode and address match
024XXXOnly postcode matches, address failure
040XXXPostcode failure
041XXXPostcode failure
042XXXPostcode failure, only address matches
044XXXPostcode and address failure
100XXXUnverified CVV2
101XXXUnverified CVV2 and addres
102XXXOnly address matches
104XXXAddress failure
110XXXUnverified CVV2 and postcode
111XXXUnverified data
112XXXOnly address matches
114XXXAddress failure
120XXXOnly postcode matches
121XXXOnly postcode matches
122XXXPostcode and address match
124XXXOnly postcode matches, address failure
140XXXPostcode failure
141XXXPostcode failure
142XXXPostcode failure, only address matches
144XXXPostcode and address failure
200XXXOnly CVV2 matches
201XXXOnly CVV2 matches
202XXXCVV2 and address match
204XXXOnly CVV2 matches, address failure
210XXXOnly CVV2 matches
211XXXOnly CVV2 matches
212XXXCVV2 and address match
214XXXOnly CVV2 matches, address failure
220XXXCVV2 and address match
221XXXCVV2 and address match
222XXXAll data matches
224XXXCVV2 and postcode match, address failure
240XXXOnly CVV2 matches, postcode failure
241XXXOnly CVV2 matches, postcode failure
242XXXCVV2 and address match, postcode failure
244XXXOnly CVV2 matches, postcode and address failure
400XXXCVV2 failure
401XXXCVV2 failure
402XXXCVV2 failure, only address matches
404XXXCVV2 and address failure
410XXXCVV2 failure
411XXXCVV2 failure
412XXXCVV2 failure, only address matches
414XXXCVV2 and address failure
420XXXCVV2 failure, only postcode matches
421XXXCVV2 failure, only postcode matches
422XXXCVV2, postcode and address match
424XXXCVV2 failure, postcode match, address failure
440XXXCVV2 and postcode failure
441XXXCVV2 and postcode failure
442XXXCVV2 and postcode failure, only address matches
444XXXNo data matches

Note: X means any valid digit. 

Comparte este documento
Tabla de Contenidos

Consulta la documentación de las distintas secciones de integraciones:

Comienza a integrar

undraw_add_to_cart_re_wrdo 1 (1) (1)

Plugins para CMS

Complementa la integración

SDKs

Métodos de pago

Herramientas

Addon Payments

Consulta la documentación de Addon Payments. Aquí tienes las distintas secciones:

Integraciones

Consultas frecuentes

Portal Backoffice

Cyberpac

We are currently working on the English version of the Cyberpac documentation. You can view the Spanish version using the buttons below:

Canales BackOffice Portal

Plugins integration

Custom integrations

POS integrated Payments

Create a solution that will help you automate processes. You can even add payment processes on physical terminals.

Payment Integrated with Android POS

Payment Integrated with Smartphone POS

POS Data sheets

Addon Payments

Comercia Global Payments has several integration options so you can choose the most efficient one for you.

Integrations

Frequently Asked Questions

BackOffice Portal

Consult the documentation of the different integrations sections:​

Start integration

undraw_add_to_cart_re_wrdo 1 (1) (1)

CMS Plugins

Complement your integration

SDKs

Payment Methods

Tools