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
  • 20: MerchantTransactionID is duplicated
  • 100: Invalid route
  • 293: Transaction rejected by fraud provider
  • 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: CardDetails.HolderName is invalid
  • 1007: CardDetails.Number is invalid
  • 1008: CardDetails.ExpirationMonth is invalid
  • 1009: CardDetails.ExpirationYear is invalid
  • 1010: CardDetails.SecurityCode is invalid
  • 1011: CardDetails – Card is expired
  • 1012: Address.City is invalid
  • 1013: Address.ZipCode is invalid
  • 1014: Address.State is invalid
  • 1015: Address.Street is invalid
  • 1016: Address.StreetNumber is invalid
  • 1017: Address.HouseNumber is invalid
  • 1018: Address.HouseExtension is invalid
  • 1019: Address.CountryCode is invalid
  • 1020: Address.Country does not exist
  • 1021: Customer.MerchantCustomerID is invalid
  • 1022: Customer.Email is invalid
  • 1023: Customer.Firstname is invalid
  • 1024: Customer.Lastname is invalid
  • 1025: Customer.Gender is invalid
  • 1026: Customer.SocialSecurityNumber is invalid
  • 1027: Customer.Phone is invalid
  • 1028: Customer.Company is invalid
  • 2400: Token is invalid
  • 2401: Token value is not available
  • 2402: Token usage limit exceeded
  • 2403: Credit card invalid for the token
  • 2404: Missing token details
  • 2600: Missing credit card details
  • 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
  • 5132: CVV2/CVC2 is mandatory!
  • 5133: Country not supported
  • 5134: Confirmation for this pre-authorisation already exists
  • 5135: Merchant has no authorization to use this API
  • 5136: Billing address is required
  • 5137: Test
  • 5138: Social security number is required
  • 5139: Invalid social security number