Card Processing Return Codes

When an API error occurs, an HTTP 4xx or HTTP 5xx status is returned with a code that provides more detailed information in the response.

List of possible Return Code IDs for credit card transactions:

  • 1: Invalid data
  • 2: Validation failed
  • 13: Generic error
  • 17: Payment is invalid
  • 18: Technical error
  • 19: Database technical error
  • 20: Key is duplicated
  • 21: Payment has already been processed
  • 22: Payout has already been processed
  • 23: Refund has already been processed
  • 100: Invalid route
  • 101: Invalid integration type usage
  • 102: Technical error occurred when processing the form
  • 103: Too many attempts for the current transaction
  • 104: Transaction lifetime expired
  • 105: Action is invalid
  • 106: Invalid offset
  • 107: Invalid limit
  • 108: Country is invalid
  • 109: Currency is invalid
  • 110: Merchant transaction ID is invalid
  • 111: Amount is invalid
  • 112: DateTime is invalid
  • 113: Method Transaction ID is invalid
  • 114: Skin ID is invalid
  • 115: Invalid fraud provider
  • 116: Transaction rejected by fraud provider
  • 117: Transaction challenged by fraud provider
  • 118: Transaction rejected by merchant
  • 119: Transaction cancelled by customer
  • 120: Initial Transaction ID is invalid
  • 121: BIN is invalid
  • 122: Installments are not supported for received country
  • 123: Installments are not supported for received BIN
  • 1000: Payment.MerchantTransactionID is invalid
  • 1001: Payment.Amount is invalid
  • 1002: Payment.Currency is invalid
  • 1003: Payment.ReturnURL is invalid
  • 1004: Payment.Description is invalid
  • 1005: Payment.StatementDescriptor is invalid
  • 1006: Payment.State is invalid
  • 1007: Payment.Language is invalid
  • 1008: Payment.Token is invalid
  • 1009: Payment.FraudCheckMode is invalid
  • 1010: Payment is in process
  • 1011: Payment.OriginatorTransactionID is invalid
  • 1012: Payment.AmountToCapture format is invalid
  • 1013: Payment.AmountToCapture exceeds initial payment authorized amount
  • 1014: Payment partial capture is not supported
  • 1200: CardDetails.HolderName is invalid
  • 1201: CardDetails.Number is invalid
  • 1202: CardDetails.ExpirationMonth is invalid
  • 1203: CardDetails.ExpirationYear is invalid
  • 1204: CardDetails.SecurityCode is invalid
  • 1205: CardDetails – Card is expired
  • 1206: CardDetails are missing
  • 1300: ThreeDSecure – Card not enrolled
  • 1301: ThreeDSecure – Card enrollment verification error
  • 1302: ThreeDSecure – Authentication failed
  • 1303: ThreeDSecure – Authentication error
  • 1304: ThreeDSecure – Authentication unavailable
  • 1400: Address is required
  • 1401: Address.City is invalid
  • 1402: Address.ZipCode is invalid
  • 1403: Address.State is invalid
  • 1404: Address.Street is invalid
  • 1405: Address.StreetNumber is invalid
  • 1406: Address.HouseNumber is invalid
  • 1407: Address.HouseExtension is invalid
  • 1408: Address.CountryCode is invalid
  • 1409: Address.Country does not exist
  • 1410: Address.ID is invalid
  • 1600: Customer.MerchantCustomerID is invalid
  • 1601: Customer.Email is invalid
  • 1602: Customer.Firstname is invalid
  • 1603: Customer.Lastname is invalid
  • 1604: Customer.Gender is invalid
  • 1605: Customer.SocialSecurityNumber is invalid
  • 1606: Customer.Phone is invalid
  • 1607: Customer.Company is invalid
  • 1608: Customer.ID is invalid
  • 1609: Customer is required
  • 1800: Invalid provider information
  • 1801: Duplicate provider transaction
  • 2000: Payout.MerchantTransactionID is invalid
  • 2001: Payout.Amount is invalid
  • 2002: Payout.Currency is invalid
  • 2003: Payout.Description is invalid
  • 2004: Payout.StatementDescriptor is invalid
  • 2005: Payout.State is invalid
  • 2200: Refund.MerchantTransactionID is invalid
  • 2201: Refund.Amount is invalid
  • 2202: Refund.Currency is invalid
  • 2203: Refund.Description is invalid
  • 2204: Refund.StatementDescriptor is invalid
  • 2205: Refund.State is invalid
  • 2206: Refund.Amount exceeds initial payment available amount
  • 2207: Another refund is in process
  • 2208: Partial refunds are not available
  • 2209: Refund.OriginatorTransactionID is invalid
  • 2400: Credit card token is invalid
  • 2401: Credit card token value is not available
  • 2402: Credit card token usage limit exceeded
  • 2403: Credit card invalid for the card token
  • 2404: Missing credit card token details
  • 2405: Credit card token is inactive
  • 2406: Credit card token already exists for received card data
  • 2600: Missing credit card details
  • 2800: MerchantSite.ID is invalid
  • 2801: MerchantSite.merchantID is invalid
  • 2802: MerchantSite.URL is invalid
  • 2803: MerchantSite.NotificationURL is invalid
  • 2804: MerchantSite.ApiKey is invalid
  • 2805: MerchantSite.DisplayName is invalid
  • 2806: MerchantSite.Country does not exist
  • 2807: MerchantSite.FraudCheckMode is invalid
  • 4996: Payment is PartiallyCaptured but status is Exception
  • 4997: Payment is Captured but status is Exception
  • 4998: Payment is Authorized but status is Exception
  • 4999: Fraud provider return code is missing or not mapped
  • 5000: Acquirer route return code is missing or not mapped
  • 5001: AVS Mismatch Failure
  • 5002: AVS Mismatch Failure
  • 5003: CVV2 Mismatch Failure
  • 5004: Sorry, the transaction failed Cybersource Fraud Test and was voided
  • 5005: Transaction may not be marked
  • 5006: orderID was not marked successfully
  • 5007: Test Tran. Bad Card
  • 5008: Test Tran. Problem
  • 5009: Username already exists
  • 5010: Username is blank
  • 5011: Fraud Screen Failure
  • 5012: Missing PIN Code
  • 5013: Invalid Bank Acct. No.
  • 5014: Invalid Bank Routing No.
  • 5015: Invalid/Missing Check No.
  • 5016: Invalid card for test transaction
  • 5017: Invalid CVV2/CVC2 No.
  • 5018: Expired card
  • 5019: Missing Data
  • 5020: Missing Email Address
  • 5021: Zip Code does not match Billing State
  • 5022: Invalid Billing Zip Code
  • 5023: Zip Code does not match Shipping State
  • 5024: Invalid Shipping Zip Code
  • 5025: Invalid Credit Card CVV2/CVC2 Format
  • 5026: Maximum number of attempts has been exceeded
  • 5027: Credit Card number has been flagged and can not be used to access this service
  • 5028: IP Address is on Blocked List
  • 5029: Billing country does not match ipaddress country
  • 5030: US based ipaddresses are currently blocked
  • 5031: Credit Cards issued from this country are currently not being accepted
  • 5032: Credit Cards issued from this bank are currently not being accepted
  • 5033: Daily volume exceeded
  • 5034: Too many transactions within allotted time
  • 5035: Sales for this phone number are currently not being accepted
  • 5036: Email Address is on Blocked List
  • 5037: Duplicate Transaction error
  • 5038: Missing/incorrect password
  • 5039: Account not configured for mobil administration
  • 5040: IP Not registered to username
  • 5041: Mode not permitted for this account
  • 5042: Currently Blank
  • 5043: Currently Blank
  • 5044: Processor not responding
  • 5045: Missing merchant/publisher name
  • 5046: Currently Blank
  • 5047: Discount exceeds available gift certificate balance
  • 5048: Gift certificate discount does not match order
  • 5049: Capture failed but will retry again later
  • 5050: Cancel failed but will retry again later
  • 5051: Refund failed at provider
  • 5052: Security code (CVV2/CVC2) is incorrect
  • 5053: Do not Honour
  • 5054: Not sufficient funds
  • 5055: Invalid card number
  • 5056: Merchant does not allow card to be sent
  • 5057: The merchant does not allow Card on File operations
  • 5058: Card temporarily blocked by issuing bank or under suspicion of fraud
  • 5059: Rejection without specifying motive
  • 5060: Operation not allowed for this type of card
  • 5061: Invalid transaction card / issuer / acquirer
  • 5062: Operation rejected to avoid duplicities
  • 5063: Transaction not permitted on card
  • 5064: Technical error upstream processor/gateway
  • 5065: Card not found within table of ranges
  • 5066: Pickup Card
  • 5067: Decline Cvv2 failure
  • 5068: Issuer not available
  • 5069: Card brand not accepted
  • 5070: Wrong Expiration Date
  • 5071: Restricted card
  • 5072: Card blocked by issuing bank or under suspicion of fraud
  • 5073: Error in holder authentication
  • 5074: The CVV2 has more than three positions
  • 5075: No Credit Account
  • 5076: Technical error – Invalid merchant
  • 5077: Technical error – unable to capture payment
  • 5078: Invalid amount
  • 5079: Unable to go online
  • 5080: Forward to issuer
  • 5081: Customer contacted the issuing bank and revoked all the authorizations orders
  • 5082: Customer contacted the issuing bank and revoked the authorization
  • 5083: Stop Payment Order
  • 5084: Card Authentication failed
  • 5085: Unsafe PIN
  • 5086: PIN Change/Unblock request declined
  • 5087: Invalid biller information
  • 5088: Cashback request exceeds issuer limit
  • 5089: Cash service not available
  • 5090: Force STIP
  • 5091: Surcharge amount not permitted on Visa cards (U.S. acquirers only)
  • 5092: Decline.MAC error (Private use only)
  • 5093: Transaction cannot be completed; violation of law
  • 5094: Destination cannot be found for routing
  • 5095: No reason to decline a request for account number verification, address verification, or CVV2 verification
  • 5096: Unable to verify PIN
  • 5097: Decline.Invalid business date
  • 5098: Previous message located for a repeat or reversal, but repeat or reversal data are inconsistent with original message
  • 5099: Unable to locate previous message (no match on Retrieval Reference number)
  • 5100: Allowable number of PIN-entry tries exceeded
  • 5101: Unable to Capture Payment – the confirmation of autorisation date cannot exceed pre-autorisation date by more than 7 days
  • 5102: Decline.Card acceptor call acquirer’s security department
  • 5103: Activity count limit exceeded
  • 5104: Security violation
  • 5105: Activity amount limit exceeded
  • 5106: Decline.Card acceptor contact acquirer
  • 5107: Transaction not allowed at terminal
  • 5108: Transaction not permitted to cardholder
  • 5109: Incorrect PIN
  • 5110: No savings account
  • 5111: No checking account
  • 5112: Decline.No investment account
  • 5113: Decline.No universal account
  • 5114: Decline.Request function not supported
  • 5115: Decline.No credit account
  • 5116: Capture Card acceptor call acquirer security
  • 5117: Completed partially
  • 5118: Unable to locate record in le, or account number is missing from the inquiry
  • 5119: Decline.Unacceptable transaction fee
  • 5120: No action taken (unable to back out prior transaction)
  • 5121: Re-enter transaction
  • 5122: Decline.Member dispute
  • 5123: Decline.Member cancellation
  • 5124: No such issuer
  • 5125: Invalid account number (no such number)
  • 5126: Invalid transaction
  • 5127: Honor with ID
  • 5128: Refer to card issuer
  • 5129: Request in progress
  • 5130: Partial Approval
  • 5131: V.I.P. approval
  • 5132: CVV2/CVC2 is mandatory!
  • 5133: Country not supported
  • 5134: Confirmation for this pre-authorisation already exists
  • 5135: Refund that was sent in the same minute denied to avoid duplication
  • 5136: Issuing bank does not allow automatic authorization. It is necessary to call your authorization center to obtain manual approval.
  • 5137: Cancel period expired
  • 5141: Invalid BIN
  • 5142: This card does not allow pre-authorization operations
  • 5143: No operation to make refund
  • 5144: Frequency limit exceeded
  • 5145: Security Violation
  • 5146: Wrong customer details (check email, name, SSN etc.)
  • 5147: Empty customer detail (check email, name, SSN etc.)
  • 5148: User must be adult
  • 5149: Invalid transaction status
  • 5150: Email associated with another country
  • 5151: Currency not allowed for this country
  • 5152: Mismatch credit card – user data
  • 5153: Rejected by bank
  • 5154: Pending for contingency
  • 5155: Rejected due to blacklisted card
  • 5156: Card is disabled
  • 5157: Rejected due to score validation
  • 5158: Transaction rejected due to velocity checks. Merchant website needs to be verified.
  • 5159: CONTACT ISSUER – Issuing bank does not allow automatic authorisation. It is necessary to call your authorisation centre to obtain manual approval.
  • 5160: User unauthorized (customer SSN blacklisted)
  • 5161: Number of attempts with erroneous PIN exceeded
  • 5162: Cancellation for this pre-authorization already exists
  • 5163: The pre-authorization to be cancelled is not authorized
  • 5164: Merchant has no authorization to use this API
  • 5165: This payment is not cancellable
  • 5166: The customer has exceeded the balance or credit limit available on their card
  • 5167: Card is expired or the customer has entered the wrong expiry date.
  • 5168: 3DSecure Response from issuer contains errors. Unable to verify 3D Secure result.
  • 5169: Operation exceeds an operating limit defined upstream.
  • 5170: Incorrect currency configuration. Please contact support@smart2pay.com
  • 5171: Technical configuration issue. Please contact support@smart2pay.com
  • 5172: Card Number does not meet the check-digit
  • 5173: Technical error upstream. Please contact support@smart2pay.com
  • 5174: Error. The card number can not have more than 19 positions
  • 5175: The card was not authenticated as 3D Secure
  • 5176: The card used is not enrolled in 3DSecure
  • 5177: Rejected by issuer because PIN is missing. Issuer blocked card for online transactions
  • 5178: The currency provided is not allowed (e.g. currency for a refund is not equal to the currency of the original payment)
  • 5179: The credit card number has a wrong format or number is not valid for the payment method’s card scheme or CVC not provided.
  • 5180: Currency was not provided
  • 5181: The payment action is not allowed for the current state the payment is.
  • 5182: The Payment Recurrence cannot be stopped.
  • 5183: Technical error upstream. Please retry.
  • 6000: Custom reason