Knowledge Article Detail Page - CYBS | Cybersource Support Center

What can we help you with?

Article Number

KA-04103

Article Total View Count

1374

Last Modified Date

07/11/2024 14:17 PM

Version

2.0

Visa Acceptance Solutions (including Cybesource) transaction responses will contain either reason codes, reply flags, or status depending upon the integration method employed.

The REST APIs saw a shift from Reason Code to Status. The Status field represents the overall status of the requested transaction. For successful transactions, 'status' is the only field returned in the REST response. Other responses such as a decline will contain Status and Reason as shown in the table.

Payment Status and responses may vary based on which Payment processor is configured for use on a given Organization ID. It is recommended that merchants test with their processor triggers in the Test environment. Please refer to the Testing Guide for more information on processor decline triggers.

The Table below only applies to REST API status and reason when using the Payments endpoint.

Sandbox API endpoint: https://apitest.cybersource.com/pts/v2/payments
Production API endpoint: https://api.cybersource.com/pts/v2/payments

Reason Code	Reply Flag	REST API		Description	Possible Action
Reason Code	Reply Flag	Status	Reason	Description	Possible Action
100	SOK	AUTHORIZED	N/A	Successful transaction
101	DMISSINGFIELD	INVALID_REQUEST	MISSING_FIELD	Declined - The request is missing one or more fields	See the reply fields missingField_0...N for which fields are invalid. Resend the request with the correct information.
102	DINVALIDDATA	INVALID_REQUEST	INVALID_DATA	Declined - One or more fields in the request contains invalid data.	See the reply fields invalidField_0...N for which fields are invalid. Resend the request with the correct information.

					I'm receiving Reason Code 102
104	DDUPLICATE	INVALID_REQUEST	DUPLICATE_REQUEST	Declined - The merchantReferenceCode sent with this authorization request matches the merchantReferenceCode of another authorization request that you sent in the last 15 minutes.	Resend the request with a unique merchantReferenceCode value.
110	SPARTIALAPPROVAL	PARTIAL_AUTHORIZED	N/A	Partial amount was approved	Partial Authorizations in Credit Card Services Using the Simple Order API
150	ESYSTEM	SERVER_ERROR	SYSTEM_ERROR	Error - General system failure.	A system error occurred.

					You must design your transaction management system to include a way to correctly handle system errors. Depending on which payment processor is handling the transaction, the error might indicate a valid system error, or it might indicate a processor rejection because of some type of invalid data. In either case, it is best not to design your system to endlessly try to resend a transaction when a system error occurs. See the documentation for your chosen connection method(s) for important information about how to handle system errors and retries.
151	ETIMEOUT	SERVER_ERROR	SERVER_TIMEOUT	Error - The request was received but there was a server timeout. This error does not include timeouts between the client and the server.	To avoid duplicating the transaction, do not resend the request until you have reviewed the transaction status in the Business Center. See the documentation for your chosen connection method(s) for information about how to handle retries in the case of system errors.
152	ETIMEOUT	SERVER_ERROR	SERVER_TIMEOUT	Error: The request was received, but a service did not finish running in time.	To avoid duplicating the transaction, do not resend the request until you have reviewed the transaction status in the Enterprise Business Center. See the documentation for your chosen connection method(s) for information about how to handle retries in the case of system errors.
200	DAVSNO	AUTHORIZED_PENDING_REVIEW	AVS_FAILED	Soft Decline - The authorization request was approved by the issuing bank but flagged by our transaction servers because it did not pass the Address Verification Service (AVS) check.	You can capture the authorization, but consider reviewing the order for the possibility of fraud.
200	DAVSNO				I'm receiving reason code 200
201	DCALL	AUTHORIZED_PENDING_REVIEW	CONTACT_PROCESSOR	Decline - The issuing bank has questions about the request. You do not receive an authorization code programmatically, but you might receive one verbally by calling the processor.	Call your processor to possibly receive a verbal authorization. For contact phone numbers, refer to your merchant bank information.
202	DCARDEXPIRED	DECLINED	EXPIRED_CARD	Decline - Expired card. You might also receive this if the expiration date you provided does not match the date the issuing bank has on file.	Request a different card or other form of payment.

				Note: The ccCreditService does not check the expiration date; instead, it passes the request to the payment processor. If the payment processor allows issuance of credits to expired cards, we will not limit this functionality.
203	DCARDREFUSED	DECLINED	PROCESSOR_DECLINED	Decline - General decline of the card. No other information provided by the issuing bank.	Request a different card or other form of payment.

					Transaction fails with a response of 203
204	DCARDREFUSED	DECLINED	INSUFFICIENT_FUND	Decline - Insufficient funds in the account.	Request a different card or other form of payment.
205	DCARDREFUSED	DECLINED	STOLEN_LOST_CARD	Decline - Stolen or lost card.	Refer the transaction to your customer support center for manual review.
207	DCARDREFUSED	DECLINED	ISSUER_UNAVAILABLE	Decline - Issuing bank unavailable.	Wait a few minutes and resend the request.
208	DCARDREFUSED	DECLINED	UNAUTHORIZED_CARD	Decline - Inactive card or card not authorized for card-not-present transactions.	Request a different card or other form of payment.
209	DCARDREFUSED	DECLINED	CVN_NOT_MATCH	Decline - card verification number (CVN) did not match.	Request a different card or other form of payment.
210	DCARDREFUSED	DECLINED	EXCEEDS_CREDIT_LIMIT	Decline - The card has reached the credit limit.	Request a different card or other form of payment.
211	DCARDREFUSED	DECLINED	INVALID_CVN	Decline - Invalid Card Verification Number (CVN).	Request a different card or other form of payment.
220	DCHECKREFUSED	DECLINED	DECLINED_CHECK	Decline - Generic Decline.	Request a different form of payment.
221	DCHECKREFUSED	DECLINED	BLACKLISTED_CUSTOMER	Decline - The customer matched an entry on the processor's negative file.	Review the order and contact the payment processor.
222	DCHECKREFUSED	DECLINED	SUSPENDED_ACCOUNT	Decline - customer's account is frozen	Review the order or request a different form of payment.
230	DCV	AUTHORIZED_PENDING_REVIEW	CV_FAILED	Soft Decline - The authorization request was approved by the issuing bank but flagged by our transaction servers because it did not pass the Card Verification Number (CVN) check.	You can capture the authorization, but consider reviewing the order for the possibility of fraud.

					I'm receiving reason code 230
231	DINVALIDCARD	DECLINED	INVALID_ACCOUNT	Decline - Invalid account number	Request a different card or other form of payment.
232	DINVALIDDATA	INVALID_REQUEST	CARD_TYPE_NOT_ACCEPTED	Decline - The card type is not accepted by the payment processor.	Contact your merchant bank to confirm that your account is set up to receive the card in question.
233	DINVALIDDATA	DECLINED	GENERAL_DECLINE	Decline - General decline by the processor.	Request a different card or other form of payment.
234	DINVALIDDATA	INVALID_REQUEST	INVALID_MERCHANT_CONFIGURATION	Decline - There is a problem with your CyberSource merchant configuration.	Do not resend the request. Contact our Client Services team to correct the configuration problem.
235	DINVALIDDATA	INVALID_REQUEST	EXCEEDS_AUTH_AMOUNT	Decline - The requested amount exceeds the originally authorized amount. Occurs, for example, if you try to capture an amount larger than the original authorization amount.	Issue a new authorization and capture request for the new amount.
236	DINVALIDDATA	INVALID_REQUEST	PROCESSOR_UNAVAILABLE	Decline - Processor failure.	Wait a few minutes and resend the request.
237	DINVALIDDATA	INVALID_REQUEST	AUTH_ALREADY_REVERSED	Decline - The authorization has already been reversed.	No action required.
238	DINVALIDDATA	INVALID_REQUEST	TRANSACTION_ALREADY_SETTLED	Decline - The transaction has already been settled.	No action required.
239	DINVALIDDATA	INVALID_REQUEST	INVALID_AMOUNT	Decline - The requested transaction amount must match the previous transaction amount.	Correct the amount and resend the request.
240	DINVALIDDATA	INVALID_REQUEST	INVALID_CARD_TYPE	Decline - The card type sent is invalid or does not correlate with the credit card number.	Confirm that the card type correlates with the credit card number specified in the request, then resend the request.
241	DINVALIDDATA	INVALID_REQUEST	INVALID_PAYMENT_ID	Decline - The referenced request id is invalid for all follow-on transactions.	No action required.
242	DNOAUTH	INVALID_REQUEST	MISSING_AUTH	Decline - The request ID is invalid.	Request a new authorization, and if successful, proceed with the capture.

				You requested a capture, but there is no corresponding, unused authorization record. Occurs if there was not a previously successful authorization request or if the previously successful authorization has already been used in another capture request.
243	DINVALIDDATA	INVALID_REQUEST	TRANSACTION_ALREADY_REVERSED_OR_SETTLED	Decline - The transaction has already been settled or reversed.	No action required.
246	DNOTVOIDABLE	INVALID_REQUEST	NOT_VOIDABLE	Decline - The capture or credit is not voidable because the capture or credit information has already been submitted to your processor. Or, you requested a void for a type of transaction that cannot be voided.	No action required.
247	DINVALIDDATA	INVALID_REQUEST	CAPTURE_ALREADY_VOIDED	Decline - You requested a credit for a capture that was previously voided.	No action required.
248	DBOLETODECLINED	DECLINED	BOLETO_DECLINED	Decline - The boleto request was declined by your processor.
250	ETIMEOUT	SERVER_ERROR	PROCESSOR_TIMEOUT	Error - The request was received, but there was a timeout at the payment processor.	To avoid duplicating the transaction, do not resend the request until you have reviewed the transaction status in the Enterprise Business Center.
251	DCARDREFUSED	DECLINED	DEBIT_CARD_USAGE_LIMIT_EXCEEDED	Decline - The Pinless Debit card's use frequency or maximum amount per use has been exceeded.	Request a different card or other form of payment.
254	DINVALIDDATA	INVALID_REQUEST	ACCOUNT_NOT_ALLOWED_CREDIT	Decline - Account is prohibited from processing stand-alone refunds.	Submit a follow-on credit by including a request ID in the credit
					request. A follow-on credit must be requested within 60 days of the authorization.
					To process stand-alone credits, contact our Client Services team
					to find out if your processor supports stand-alone credits.
400	DSCORE	REJECTED	SCORE_EXCEEDS_THRESHOLD	Soft Decline - Fraud score exceeds threshold.	You can capture the authorization, but consider reviewing the order for the possibility of fraud.
450	DINVALIDADDRESS	DECLINED	APARTMENT_NUMBER_NOT_FOUND	Apartment number missing or not found.	Ask the customer to verify the address information and
450	DINVALIDADDRESS	DECLINED	APARTMENT_NUMBER_NOT_FOUND	Apartment number missing or not found.	resend the request.
451	DINVALIDADDRESS	DECLINED	INSUFFICIENT_ADDRESS_INFORMATION	Insufficient address information.	Ask the customer to verify the address information and
451	DINVALIDADDRESS	DECLINED	INSUFFICIENT_ADDRESS_INFORMATION	Insufficient address information.	resend the request.
452	DINVALIDADDRESS	DECLINED	HOUSE_OR_BOX_NUMBER_NOT_FOUND	House/Box number not found on street.	Ask the customer to verify the address information and
452	DINVALIDADDRESS	DECLINED	HOUSE_OR_BOX_NUMBER_NOT_FOUND	House/Box number not found on street.	resend the request.
453	DINVALIDADDRESS	DECLINED	MULTIPLE_ADDRESS_MATCHES	Multiple address matches were found.	Ask the customer to verify the address information and
453	DINVALIDADDRESS	DECLINED	MULTIPLE_ADDRESS_MATCHES	Multiple address matches were found.	resend the request.
454	DINVALIDADDRESS	DECLINED	BOX_NUMBER_NOT_FOUND	P.O. Box identifier not found or out of range.	Ask the customer to verify the address information and
454	DINVALIDADDRESS	DECLINED	BOX_NUMBER_NOT_FOUND	P.O. Box identifier not found or out of range.	resend the request.
455	DINVALIDADDRESS	DECLINED	ROUTE_SERVICE_NOT_FOUND	Route service identifier not found or out of range.	Ask the customer to verify the address information and
455	DINVALIDADDRESS	DECLINED	ROUTE_SERVICE_NOT_FOUND	Route service identifier not found or out of range.	resend the request.
456	DINVALIDADDRESS	DECLINED	STREET_NAME_NOT_FOUND	Street name not found in Postal code.	Ask the customer to verify the address information and
456	DINVALIDADDRESS	DECLINED	STREET_NAME_NOT_FOUND	Street name not found in Postal code.	resend the request.
457	DINVALIDADDRESS	DECLINED	POSTAL_CODE_NOT_FOUND	Postal code not found in database.	Ask the customer to verify the address information and
457	DINVALIDADDRESS	DECLINED	POSTAL_CODE_NOT_FOUND	Postal code not found in database.	resend the request.
458	DINVALIDADDRESS	DECLINED	UNVERIFIABLE_ADDRESS	Unable to verify or correct address.	Ask the customer to verify the address information and
458	DINVALIDADDRESS	DECLINED	UNVERIFIABLE_ADDRESS	Unable to verify or correct address.	resend the request.
459	DINVALIDADDRESS	DECLINED	MULTIPLE_ADDRESS_MATCHES_INTERNATIONAL	Multiple addres matches were found (international)	Ask the customer to verify the address information and
459	DINVALIDADDRESS	DECLINED	MULTIPLE_ADDRESS_MATCHES_INTERNATIONAL	Multiple addres matches were found (international)	resend the request.
460	DINVALIDADDRESS	DECLINED	ADDRESS_MATCH_NOT_FOUND	Address match not found (no reason given)	Ask the customer to verify the address information and
460	DINVALIDADDRESS	DECLINED	ADDRESS_MATCH_NOT_FOUND	Address match not found (no reason given)	resend the request.
461	DINVALIDADDRESS	DECLINED	UNSUPPORTED_CHARACTER_SET	Unsupported character set	Verify the character set that you are using to process transactions.
475	DAUTHENTICATE	PENDING_AUTHENTICATION	CONSUMER_AUTHENTICATION_REQUIRED	The cardholder is enrolled in Payer Authentication. Please authenticate the cardholder before continuing with the transaction.
476	DAUTHENTICATIONFAILED	DECLINED	CONSUMER_AUTHENTICATION_FAILED	Encountered a Payer Authentication problem. Payer could not be authenticated.
478	DAUTHENTICATE	DECLINED	CUSTOMER_AUTHENTICATION_REQUIRED	Strong customer authentication (SCA) is required for this transaction
480	DREVIEW	AUTHORIZED_PENDING_REVIEW	DECISION_PROFILE_REVIEW	The order is marked for review by Decision Manager
481	DREJECT	AUTHORIZED_RISK_DECLINED	DECISION_PROFILE_REJECT	The order has been rejected by Decision Manager
490	DAGGREJECTED	DECLINED	RISK_CONTROL_DECLINE	Your aggregator or acquirer is not accepting transactions from you at this time.
491	DAGGREJECTED	DECLINED	RISK_CONTROL_DECLINE	Your aggregator or acquirer is not accepting this transaction.
520	DSETTINGS	N/A	N/A	Soft Decline - The authorization request was approved by the issuing bank but declined by our systems based on your Smart Authorization settings.	Do not capture the authorization without further review. Review the ccAuthReply_avsCode, ccAuthReply_cvCode, and ccAuthReply_authFactorCode fields to determine why the transaction was rejected.
700	DRESTRICTED	DECLINED	CUSTOMER_WATCHLIST_MATCH	The customer matched the Denied Parties List	Reject the customer's order.
701	DRESTRICTED	DECLINED	ADDRESS_COUNTRY_WATCHLIST_MATCH	Export bill_country/ship_country match	Reject the customer's order.
702	DRESTRICTED	DECLINED	EMAIL_COUNTRY_WATCHLIST_MATCH	Export email_country match	Reject the customer's order.
703	DRESTRICTED	DECLINED	IP_COUNTRY_WATCHLIST_MATCH	Export hostname_country/ip_country match	Reject the customer's order.

Was this article helpful?

Articles Recommended for You

Reason Codes with REST API response