| Status |
|---|
| CANCELLED | Transaction Cancelled The transaction or pending refund has been cancelled by the merchant or customer. | Info | Occasional | T0 |
| COMPLETED | Transaction Completed The payment or refund has been successfully processed and settled. No further action required. | Approved | Common | T0 |
| FAILED | Transaction Failed The transaction was not successful. Review the error code for the specific reason (e.g., decline, validation error). | Error, Declined | Common | T2 |
| HELD | Transaction Held The transaction has been placed on hold pending fraud review or risk management investigation. | Processing | Occasional | T1 |
| PENDING | Transaction Pending The transaction is awaiting settlement or further processing, such as batch settlement or bank confirmation. | Processing | Occasional | T0 |
| PROCESSING | Transaction Processing The transaction has been received and is being processed asynchronously. Poll or await webhook confirmation before fulfilling orders. | Processing | Occasional | T0 |
| REVERSED | Transaction Reversed The authorization or payment has been reversed (voided). Funds will not settle or will be returned. | Info | Occasional | T0 |
| Error Code |
|---|
| 1000 | Internal Server Error An internal error occurred on Paysafe's platform. Contact Technical Support before retrying. Returned as HTTP 500. | Error | Occasional | T1 |
| 1001 | External Gateway Error (Retry) An error occurred with the external processing gateway. Retry the transaction. Returned as HTTP 502. | Error | Occasional | T0 |
| 1002 | Internal Error (Retry) An internal error occurred. Retry the transaction. Returned as HTTP 500. | Error | Occasional | T0 |
| 1003 | External Gateway Error (Do Not Retry) An error occurred with the external processing gateway. Do not retry. Contact Technical Support for more information. Returned as HTTP 500. | Error | Rare | T1 |
| 1004 | Transaction Type Not Enabled The merchant account is not enabled for the submitted transaction type. Verify parameters and retry. HTTP 400. | Error | Occasional | T1 |
| 1007 | Internal / Gateway Error (Retry) An internal or gateway error occurred. Retry the transaction. Returned as HTTP 500/502. | Error | Occasional | T0 |
| 1008 | Internal Error (Do Not Retry) An internal error occurred. Do not retry. Contact Technical Support. HTTP 500. | Error | Rare | T1 |
| 1020 | Gateway Timeout The external processing gateway timed out. Retry after a delay. HTTP 504. | Error | Occasional | T0 |
| 1200 | Rate Limit Exceeded The API call has been denied because it exceeded the permissible rate limit. Implement back-off and retry. HTTP 429. | Error | Occasional | T0 |
| 3002 | Invalid Card Number or Brand An invalid card number, brand, or combination of card number and brand was submitted. Verify and re-enter card details. HTTP 400. | Error, Declined | Common | T0 |
| 3004 | Zip Code Required for AVS The zip/postal code must be provided for an AVS check request. HTTP 400. | Error | Occasional | T0 |
| 3005 | Invalid CVV Value An incorrect CVV value was submitted. Verify and re-enter the card security code. HTTP 400. | Error, Declined | Common | T0 |
| 3006 | Expired Card (Validation) An expired credit card number was submitted during validation. Verify the expiry date. HTTP 400. | Error, Declined | Common | T3 |
| 3007 | AVS Check Failed The request failed the AVS (Address Verification System) check. The amount may still have been reserved on the customer's card and will be released in 3-5 business days. Verify the billing address. HTTP 402. | Declined | Common | T0 |
| 3008 | Card Type Not Configured The submitted card type is not configured on the merchant account. HTTP 402. | Error, Declined | Occasional | T3 |
| 3009 | Declined by Issuing Bank The request was declined by the issuing bank. The customer should contact their card issuer. HTTP 402. | Declined | Common | T2 |
| 3011 | Restricted Card The issuing bank declined because the card is restricted. Contact the cardholder's credit card company for investigation. HTTP 402. | Declined | Occasional | T2 |
| 3012 | Invalid Expiry Date The issuing bank declined because the credit card expiry date submitted is invalid. HTTP 402. | Declined | Common | T0 |
| 3013 | Credit Card Account Problem The issuing bank declined due to problems with the credit card account (e.g., account closed, suspended). HTTP 402. | Declined | Occasional | T2 |
| 3014 | Unknown Bank Response The issuing bank returned an unknown response. Contact the cardholder's credit card company. HTTP 402. | Declined | Occasional | T2 |
| 3015 | Manual Processing Required The bank requested manual transaction processing by calling the cardholder's credit card company. HTTP 402. | Declined | Rare | T2 |
| 3016 | Retrieve Card (Lost/Stolen) The bank requested card retrieval - the card may be lost or stolen. Do not retry. HTTP 402. | Declined, Error | Rare | T3 |
| 3017 | Invalid Credit Card Number An invalid credit card number was submitted. Verify and re-enter the card number. HTTP 402. | Error, Declined | Common | T0 |
| 3018 | Retry Requested by Bank The bank has requested that you retry the transaction. Implement a short delay before retrying. HTTP 402. | Declined | Occasional | T0 |
| 3019 | CVV Check Failed The request failed the CVV check. The amount may still have been reserved on the customer's card and will be released in 3-5 business days. HTTP 402. | Declined | Common | T0 |
| 3020 | Retry (Bank Request) The bank has requested a retry. Space out retry attempts per Paysafe's retry policy. HTTP 402. | Declined | Occasional | T0 |
| 3022 | Insufficient Funds The card was declined due to insufficient funds. The customer should use a different payment method or fund their account. HTTP 402. | Declined | Common | T3 |
| 3023 | Card Activity Regulations Decline The issuing bank declined due to its proprietary card activity regulations (e.g., velocity or usage rules). HTTP 402. | Declined | Occasional | T2 |
| 3024 | Transaction Not Permitted by Issuer The issuing bank does not permit this transaction for the card. The customer should contact their bank. HTTP 402. | Declined | Occasional | T3 |
| 3025 | External Gateway Invalid Data The external processing gateway reported invalid data. Verify request parameters and retry. HTTP 400. | Error | Occasional | T0 |
| 3027 | Transaction Limit Exceeded The external processing gateway reported that a limit has been exceeded. Do not retry. HTTP 402. | Declined, Error | Occasional | T3 |
| 3028 | External Gateway System Error The external processing gateway reported a system error. Retry the transaction. HTTP 502. | Error | Occasional | T0 |
| 3029 | External Gateway Rejected The external processing gateway rejected the transaction. Do not retry. Contact Technical Support. HTTP 402. | Declined, Error | Occasional | T1 |
| 3030 | Unauthorized by External Gateway The external processing gateway reported the transaction is unauthorized. Do not retry. HTTP 402. | Declined, Error | Occasional | T1 |
| 3032 | Card in Negative Database The card or email is in the issuer's or gateway's negative database. Do not retry. HTTP 402. | Declined, Error | Occasional | T3 |
| 3035 | Exceeded PIN Attempts The transaction was declined due to exceeded PIN tries. The customer should contact their bank. HTTP 402. | Declined | Rare | T2 |
| 3036 | Invalid Issuer The transaction was declined due to an invalid card issuer. HTTP 402. | Declined | Rare | T0 |
| 3037 | Invalid Transaction The transaction was declined because it is invalid. Do not retry without correcting parameters. HTTP 402. | Declined, Error | Occasional | T0 |
| 3039 | Invalid Authentication Value The transaction was declined due to an invalid authentication value (e.g., CAVV/3DS value mismatch). HTTP 402. | Declined, Error | Occasional | T0 |
| 3040 | Request Type Not Permitted on Card The transaction type is not permitted on this card. HTTP 402. | Declined | Occasional | T3 |
| 3041 | Declined - Timeout The transaction was declined due to a timeout during authorization. Retry after a delay. HTTP 402. | Declined, Error | Occasional | T0 |
| 3042 | Cryptographic Error The transaction was declined due to a cryptographic error. Verify 3DS or tokenization parameters. HTTP 402. | Declined, Error | Rare | T1 |
| 3054 | Suspected Fraud The transaction was declined due to suspected fraud by the issuing bank or processor. Do not retry. HTTP 402. | Declined, Error | Occasional | T2 |
| 3057 | Cardholder Must Call Issuer The issuer requires the cardholder to call them directly. Do not retry the transaction. HTTP 402. | Declined | Rare | T2 |
| 3060 | SCA Required The transaction was declined because Strong Customer Authentication (3DS) is required. Re-initiate the payment with 3DS challenge flow. HTTP 402. | Declined | Occasional | T0 |
| 3073 | Closed Customer Account The transaction was declined because the customer's bank account is closed. HTTP 400. | Declined | Occasional | T3 |
| 3200 | Invalid Authorization ID for Settlement An invalidly formatted Authorization ID was submitted for settlement. Verify the ID. HTTP 400. | Error | Occasional | T0 |
| 3201 | Authorization Not Found for Settlement The Authorization ID in the settlement request could not be found. HTTP 404. | Error | Occasional | T0 |
| 3202 | Max Settlements Exceeded The maximum number of settlements allowed for this authorization has been exceeded. HTTP 402. | Error | Rare | T1 |
| 3203 | Authorization Fully Settled or Cancelled The authorization is either fully settled or cancelled. No further settlement actions are possible. HTTP 402. | Error | Occasional | T0 |
| 3204 | Settlement Amount Exceeds Authorization The requested settlement amount exceeds the remaining authorized amount. HTTP 402. | Error | Occasional | T0 |
| 3205 | Authorization Expired for Settlement The authorization you are attempting to settle has expired. HTTP 402. | Error | Occasional | T0 |
| 3206 | Settlement Rejected by Gateway The external processing gateway rejected the settlement. Do not retry. Contact Technical Support. HTTP 402. | Error | Occasional | T1 |
| 3402 | Refund Exceeds Settlement Amount The requested refund amount exceeds the remaining settlement amount. HTTP 402. | Error | Occasional | T0 |
| 3403 | Max Refunds Exceeded The maximum number of refunds allowed for this settlement has been exceeded. HTTP 402. | Error | Rare | T1 |
| 3404 | Settlement Fully Refunded The settlement has already been fully refunded. No additional refunds are possible. HTTP 402. | Error | Occasional | T0 |
| 3405 | Settlement Expired for Refund The settlement you are attempting to refund has expired. HTTP 402. | Error | Occasional | T1 |
| 3406 | Settlement Not Batched Yet The settlement has not been batched yet. No settled funds are available for refund. Wait for batch settlement. HTTP 402. | Error | Occasional | T0 |
| 3407 | Settlement Not Found for Refund The settlement referenced by the transaction response ID cannot be found. Verify the ID. HTTP 400. | Error | Occasional | T0 |
| 3412 | Merchant Account in Overdraft The refund was not permitted because the merchant account is in overdraft. HTTP 402. | Error | Rare | T1 |
| 3413 | Exceeds Visa Credit Ratio The requested refund amount exceeds the permissible Visa credit ratio. HTTP 402. | Error | Rare | T1 |
| 3415 | Transaction Cannot Be Cancelled The transaction cannot be cancelled. It is no longer in a pending state (may already be completed). HTTP 402. | Error | Occasional | T0 |
| 3417 | Concurrent Request Conflict Another request is already being processed on the referenced transaction. Wait and use the confirmation number to check status. HTTP 402. | Error | Occasional | T0 |
| 3421 | Purchase Return Authorization Declined The purchase return authorization was declined by the issuing bank. HTTP 402. | Declined, Error | Rare | T1 |
| 3501 | Reversal Amount Exceeds Authorization The requested void/reversal amount exceeds the remaining authorization amount. HTTP 402. | Error | Occasional | T0 |
| 3502 | Authorization Already Settled The authorization has already been settled. A void is not possible post-settlement. HTTP 402. | Error | Occasional | T0 |
| 3503 | Reversal Not Supported for Card Type The void (authorization reversal) is not supported for the card type used. HTTP 402. | Error | Rare | T1 |
| 3504 | Partial Void Not Supported The external processing gateway does not support partial voids. The reversal amount must equal the original authorization. HTTP 402. | Error | Occasional | T1 |
| 3505 | Void Could Not Be Completed The void (authorization reversal) could not be completed due to a gateway error. HTTP 500. | Error | Rare | T1 |
| 4001 | Negative Database Match The card number or email is in Paysafe's negative database. Do not retry. HTTP 402. | Declined, Error | Occasional | T3 |
| 4002 | Risk Management Decline The transaction was declined by Paysafe's Risk Management department. Do not retry. HTTP 402. | Declined, Error | Occasional | T1 |
| 5000 | Merchant Authentication Failed Merchant account authentication failed. The store ID/password is invalid or the IP address is not authorized. Verify credentials. HTTP 401. | Error | Occasional | T1 |
| 5001 | Invalid Currency Code The submitted currency code is invalid or not supported for the merchant account. HTTP 400. | Error | Occasional | T0 |
| 5003 | Invalid Amount An invalid transaction amount was submitted. Verify the amount format and value. HTTP 400. | Error | Common | T0 |
| 5016 | Merchant Account Not Found The merchant account submitted with the request is invalid or cannot be found. Verify the account ID. HTTP 400. | Error | Occasional | T1 |
| 5017 | Merchant Account Disabled The merchant account is not enabled/disabled. Do not retry. Contact Technical Support. HTTP 400. | Error | Rare | T1 |
| 5021 | Transaction Declined The transaction request has been declined. Verify the transaction details before retrying. HTTP 402. | Declined | Common | T2 |
| 5023 | Request Not Parsable The request body is not parsable (malformed JSON or XML). Verify the request format. HTTP 400. | Error | Occasional | T0 |
| 5031 | Duplicate Transaction The transaction has already been processed. Duplicate merchant reference detected. HTTP 409. | Error | Occasional | T0 |
| 5034 | Invalid Email Address An invalid email address was submitted. Verify the format and retry. HTTP 400. | Error | Occasional | T0 |
| 5037 | Invalid Zip/Postal Code An invalid zip/postal code was submitted. Verify and retry. HTTP 400. | Error | Occasional | T0 |
| 5040 | Merchant Account Not Configured for Transaction The merchant account is not configured for the attempted transaction type. Contact Technical Support. HTTP 401. | Error | Occasional | T1 |
| 5042 | Invalid or Missing Merchant Reference The merchant reference number is missing, invalid, or exceeds the maximum permissible length. HTTP 400. | Error | Occasional | T0 |
| 5050 | Merchant Account Configuration Error An error occurred with the merchant account configuration. Contact Technical Support. HTTP 500. | Error | Rare | T1 |
| 5068 | Field Validation Error A required field is missing or a field value does not match the expected format. Review fieldErrors in the response for details. HTTP 400. | Error | Common | T0 |
| 5100 | 3DS Enrollment Check Failed (N) 3D Secure enrollment check failed - the card is not enrolled (status N). The merchant must decide whether to proceed without 3DS. | Error, Declined | Occasional | T0 |
| 5101 | 3DS Enrollment Check Failed (U) 3D Secure enrollment check failed - enrollment status is unknown (U). The merchant may proceed without 3DS at their own risk. | Error | Occasional | T0 |
| 5103 | 3DS Service Failed The 3D Secure service returned a FAILED status. Retry or fall back to a non-3DS flow if supported. | Error | Occasional | T0 |
| 5106 | 3DS Risk Rule Failed (N) The 3DS risk rule failed - the authentication result is N (Not Authenticated). Do not proceed with the transaction. | Declined, Error | Occasional | T0 |
| 5120 | Third Party 3DS Service Error The third-party 3DS service threw an error. Retry the 3DS authentication flow. | Error | Occasional | T0 |
| 5124 | 3DS Challenge Result N After the 3DS challenge/OTP flow, the threeDResult is N (Not Authenticated). Do not process the transaction. | Declined, Error | Occasional | T0 |
| 5269 | Resource Not Found The IDs specified in the URL do not correspond to values in the system. HTTP 404. | Error | Occasional | T0 |
| 5270 | Unauthorized Access The credentials provided do not have permission to access the requested data. HTTP 403. | Error | Occasional | T1 |
| 5271 | Unsupported Accept Header The 'Accept' header format in the request is not supported. Use application/json. HTTP 406. | Error | Rare | T0 |
| 5272 | Unsupported Content-Type The 'Content-Type' header is in an unsupported format. Use application/json. HTTP 406. | Error | Rare | T0 |
| 5273 | Invalid URL The client reached the application but the request could not be served due to an invalid URL. HTTP 404. | Error | Rare | T0 |
| 5275 | Credentials Expired The authentication credentials provided have expired. Regenerate and use updated credentials. HTTP 401. | Error | Occasional | T1 |
| 5276 | Credentials Disabled The authentication credentials have been disabled. Contact Technical Support. HTTP 401. | Error | Rare | T1 |
| 5277 | Credentials Locked The authentication credentials have been locked due to multiple failed authentication attempts. HTTP 401. | Error | Rare | T1 |
| 5279 | Invalid Authentication Credentials The authentication credentials are invalid (e.g., invalid JWT, wrong API key). HTTP 401. | Error | Occasional | T1 |
| 5280 | Missing Authentication Credentials Required authentication credentials were not provided in the request. HTTP 401. | Error | Occasional | T1 |
| 5281 | HTTP Method Not Supported The HTTP method (e.g., PUT where only POST is accepted) is not supported for this endpoint. HTTP 405. | Error | Occasional | T0 |
| 5500 | Invalid Payment Token The payment token is invalid or the corresponding profile or credit card is not active. HTTP 400. | Error | Occasional | T0 |
| 5501 | No Active Credit Card on Profile The profile does not have an active credit card. Add or activate a card before retrying. HTTP 400. | Error | Occasional | T0 |
| 9000 | No Child Accounts for Load Balancing The transaction could not be processed because the merchant account has no available child accounts for load balancing. Contact Technical Support. HTTP 500. | Error | Rare | T1 |
| ADVICE-01 | Issuer Will Never Approve The issuer will never approve this transaction. Do not retry. | Declined | Occasional | T3 |
| ADVICE-02 | Cannot Approve at This Time The issuer cannot approve at this time. Do not retry more than 10 times over 30 days. | Declined | Occasional | T2 |
| ADVICE-03 | Revalidate Payment Information Revalidate payment information before retrying. Do not retry more than 10 times over 30 days. | Declined | Common | T0 |
| ADVICE-04 | Cardholder Must Contact Issuer The cardholder needs to contact their issuer. Do not retry more than 10 times over 30 days. | Declined | Occasional | T2 |
| ADVICE-08 | Retry After 1 Hour Retry this transaction after 1 hour. | Declined, Processing | Occasional | T0 |
| ADVICE-09 | Retry After 24 Hours Retry this transaction after 24 hours. | Declined, Processing | Occasional | T0 |
| ADVICE-42 | Sanctions Score Threshold Exceeded The transaction was declined because the sanctions scoring service score exceeded the applicable threshold value. | Declined, Error | Rare | T1 |
| ISO-00 | Approved ISO response code 00: The transaction was approved by the issuer. | Approved | Common | T0 |
| ISO-05 | Do Not Honour ISO response code 05: The issuing bank declined the transaction with a generic do-not-honor response. | Declined | Common | T2 |
| ISO-14 | Invalid PAN ISO response code 14: The card primary account number (PAN) is invalid. | Declined, Error | Occasional | T0 |
| ISO-41 | Lost Card ISO response code 41: The card has been reported lost. Do not retry. | Declined | Rare | T3 |
| ISO-43 | Stolen Card ISO response code 43: The card has been reported stolen. Do not retry. | Declined | Rare | T3 |
| ISO-51 | Non-Sufficient Funds ISO response code 51: The card account does not have sufficient funds. | Declined | Common | T3 |
| ISO-54 | Expired Card ISO response code 54: The card has expired. | Declined | Common | T3 |
| ISO-57 | Transaction Not Allowed ISO response code 57: The transaction type is not allowed for this card. | Declined | Occasional | T3 |
| ISO-61 | Exceeds Withdrawal Limit ISO response code 61: The transaction amount exceeds the card's withdrawal or purchase limit. | Declined | Occasional | T2 |
| ISO-62 | Restricted Card ISO response code 62: The card has a restriction that prevents this transaction. | Declined | Occasional | T2 |
| ISO-75 | Exceeded PIN Tries ISO response code 75: The allowable number of PIN entry attempts has been exceeded. | Declined | Rare | T2 |
| ISO-83 | Fraud / Security Decline ISO response code 83: The transaction was declined due to fraud or security concerns. | Declined, Error | Occasional | T2 |
| ISO-91 | Request Destination Not Reachable ISO response code 91: The issuer is not reachable. Retry after a delay. | Error | Occasional | T0 |
| ISO-96 | System Error ISO response code 96: Internal system error at the issuer or network. Retry after a delay. | Error | Occasional | T0 |
| PAYMENTHUB-1 | Unsupported Payment Type / Currency Combination The submitted payment type and currency code combination is not supported for the merchant account. HTTP 400. | Error | Occasional | T1 |
CAN
