What can we help you with?


000001630


17671

04/08/2024 01:20 AM

16.4

Cybersource transaction responses will contain either reason codes or reply flags, depending upon the integration method employed.


Reason Codes

reason code is a response from Cybersource servers for production transactions submitted using the following methods:

  • Simple Order API
  • Virtual Terminal
  • Secure Acceptance - Hosted Checkout
  • Secure Acceptance - Checkout API
  • SOAP Toolkit API
  • Offline Transaction File Submission

Refer to the Reason Code/Reply Flag Descriptions table below for a description of each value.
 

Reply Flags

The SCMP integration method offers a related response value called a reply flag.

Refer to the Reason Code/Reply Flag Descriptions table below for a description of each value.
 

References

To learn more about these return values, please refer to the following:

Note: The underlying reason for a code may determined by systems upstream of Cybersource, e.g., your payment processor, and may require further investigation with those parties to understand the root cause.

Reason Code/Reply Flag Descriptions

The following table lists reason codes, corresponding SCMP reply flags, descriptions of what these values indicate, and in some cases, possible follow-up actions that you (the merchant) may take. If you receive a reason code not displayed here, please contact Support to investigate further.

Reason CodeReply Flag (SCMP)DescriptionPossible Action
100SOKSuccessful transaction 
101DMISSINGFIELDDeclined - The request is missing one or more fieldsSee the reply fields missingField_0...N for which fields are invalid. Resend the request with the correct information.
102DINVALIDDATADeclined - 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
104DDUPLICATEDeclined - 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.
110SPARTIALAPPROVALPartial amount was approvedPartial Authorizations in Credit Card Services Using the Simple Order API
150ESYSTEMError - 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 Cybersource 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 the Cybersource client (SDK) that you are using for important information about how to handle system errors and retries.
151ETIMEOUTError - 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 Cybersource client (SDK) for information about how to handle retries in the case of system errors.
152ETIMEOUTError: 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 Cybersource client (SDK) for information about how to handle retries in the case of system errors.
154ESYSTEMBad MAC keyIt signifies that the payout due to MAC validation failure. The merchant is safe to retry the payout as it has not been send to the customer. 
 
200DAVSNOSoft Decline - The authorization request was approved by the issuing bank but flagged by Cybersource 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.

I'm receiving reason code 200

201DCALLDecline - 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.
202DCARDEXPIREDDecline - Expired card. You might also receive this if the expiration date you provided does not match the date the issuing bank has on file.

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, Cybersource does not limit this functionality.
Request a different card or other form of payment.
203DCARDREFUSEDDecline - 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
204DCARDREFUSEDDecline - Insufficient funds in the account.Request a different card or other form of payment.
205DCARDREFUSEDDecline - Stolen or lost card.Refer the transaction to your customer support center for manual review.
207DCARDREFUSEDDecline - Issuing bank unavailable.Wait a few minutes and resend the request.
208DCARDREFUSEDDecline - Inactive card or card not authorized for card-not-present transactions.Request a different card or other form of payment.
209DCARDREFUSEDDecline - card verification number (CVN) did not match.Request a different card or other form of payment.
210DCARDREFUSEDDecline - The card has reached the credit limit.Request a different card or other form of payment.
211DCARDREFUSEDDecline - Invalid Card Verification Number (CVN).Request a different card or other form of payment.
220DCHECKREFUSEDDecline - Generic Decline.Request a different form of payment.
221DCHECKREFUSEDDecline - The customer matched an entry on the processor's negative file.Review the order and contact the payment processor.
222DCHECKREFUSEDDecline - customer's account is frozenReview the order or request a different form of payment.
230DCVSoft Decline - The authorization request was approved by the issuing bank but flagged by Cybersource 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
231DINVALIDCARDDecline - Invalid account numberRequest a different card or other form of payment.
232DINVALIDCARDDecline - 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.
233DINVALIDDATADecline - General decline by the processor.Request a different card or other form of payment.
234DINVALIDDATADecline - There is a problem with your Cybersource merchant configuration.Do not resend the request. Contact Customer Support to correct the configuration problem.
235DINVALIDDATADecline - 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.
236DINVALIDDATADecline - Processor failure.Wait a few minutes and resend the request.
237DINVALIDDATADecline - The authorization has already been reversed.No action required.
238DINVALIDDATADecline - The transaction has already been settled.No action required.
239DINVALIDDATADecline - The requested transaction amount must match the previous transaction amount.Correct the amount and resend the request.
240DINVALIDDATADecline - 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.
241DINVALIDDATADecline - The referenced request id is invalid for all follow-on transactions.No action required.
242DNOAUTHDecline - The request ID is invalid.

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.
Request a new authorization, and if successful, proceed with the capture.
243DINVALIDDATADecline - The transaction has already been settled or reversed.No action required.
246DNOTVOIDABLEDecline - 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.
247DINVALIDDATADecline - You requested a credit for a capture that was previously voided.No action required.
248DBOLETODECLINEDDecline - The boleto request was declined by your processor. 
250ETIMEOUTError - 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.
251DCARDREFUSEDDecline - The Pinless Debit card's use frequency or maximum amount per use has been exceeded.Request a different card or other form of payment.
254DINVALIDDATADecline - 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 your Cybersource account representative
to find out if your processor supports stand-alone credits.
268ETIMEOUTTransaction Error: Unable to confirm, please contact Barclaycard help desk. Do not re-processContact Barclays to understand payment status to know if the consumer received their funds.
400DSCORESoft Decline - Fraud score exceeds threshold.You can capture the authorization, but consider reviewing the order for the possibility of fraud.
450DINVALIDADDRESSApartment number missing or not found.Ask the customer to verify the address information and
resend the request.
451DINVALIDADDRESSInsufficient address information.Ask the customer to verify the address information and
resend the request.
452DINVALIDADDRESSHouse/Box number not found on street.Ask the customer to verify the address information and
resend the request.
453DINVALIDADDRESSMultiple address matches were found.Ask the customer to verify the address information and
resend the request.
454DINVALIDADDRESSP.O. Box identifier not found or out of range.Ask the customer to verify the address information and
resend the request.
455DINVALIDADDRESSRoute service identifier not found or out of range.Ask the customer to verify the address information and
resend the request.
456DINVALIDADDRESSStreet name not found in Postal code.Ask the customer to verify the address information and
resend the request.
457DINVALIDADDRESSPostal code not found in database.Ask the customer to verify the address information and
resend the request.
458DINVALIDADDRESSUnable to verify or correct address.Ask the customer to verify the address information and
resend the request.
459DINVALIDADDRESSMultiple address matches were found (international)Ask the customer to verify the address information and
resend the request.
460DINVALIDADDRESSAddress match not found (no reason given)Ask the customer to verify the address information and
resend the request.
461DINVALIDADDRESSUnsupported character setVerify the character set that you are using to process transactions.
474DAUTHENTICATEPIN Data RequiredAsk the customer to enter their PIN code to authenticate
475DAUTHENTICATEThe cardholder is enrolled in Payer Authentication. Please authenticate the cardholder before continuing with the transaction.Authenticate the cardholder before continuing with the transaction.
476DAUTHENTICATIONFAILEDEncountered a Payer Authentication problem. Payer could not be authenticated.Authenticate the cardholder before continuing with the transaction.
478DAUTHENTICATEStrong customer authentication (SCA) is required for this transaction.Resubmit using SCA.
480DREVIEWThe order is marked for review by Decision ManagerDepending on your permissions, you can:
- Accept, reject, or settle the order.
- Void or reverse the authorization.
- Take no action. If no action is taken, the order will be rejected after 30 days.

See Decision Manager or Fraud Management Essentials.
481DREJECTThe order has been rejected by Decision ManagerDepending on your permissions, you can:
- Convert the order to an Accepted status.
- If the authorization has not been sent to the payment processor for settlement, it can be voided.
- If the authorization has been sent to the payment processor for settlement but is not yet settled, it can be reversed.
- If the transaction has an authorization code, it can be settled.

See Decision Manager or Fraud Management Essentials.
490 Your aggregator or acquirer is not accepting transactions from you at this time.Contact your acquirer or payment technology partner.
491 Your aggregator or acquirer is not accepting this transaction.Contact your acquirer or payment technology partner.
520DSETTINGSSoft Decline - The authorization request was approved by the issuing bank but declined by Cybersource 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 Cybersource rejected the request.
700DRESTRICTEDThe customer matched the Denied Parties ListReject the customer's order.
701DRESTRICTEDExport bill_country/ship_country matchReject the customer's order.
702DRESTRICTEDExport email_country matchReject the customer's order.
703DRESTRICTEDExport hostname_country/ip_country matchReject the customer's order.


Was this article helpful?


Articles Recommended for You