Paysafe Error Code 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.
What it means
Paysafe error code 3002 is a client-side request error indicating that the payment gateway received an invalid Primary Account Number (PAN), an unsupported card brand, or a mismatch between the submitted brand and the card number. This returns an HTTP 400 status, signifying a data formatting or configuration issue at the gateway level rather than a decline from the issuing bank. The transaction cannot proceed with the current data payload.
Classification & retryability
Do not automatically retry the same payload. You must first correct the card number, fix the brand mismatch, or prompt the customer to use a supported card type before reattempting the transaction.
Common causes
- The submitted Primary Account Number (PAN) contains a typo or is generally invalid.
- The transaction includes a mismatch between the card brand flag and the PAN, such as passing a Visa brand flag for a Mastercard number.
- The customer attempted to use a card brand that is not currently supported or enabled on your Paysafe merchant account.
How to resolve it
First, verify that the card brand being submitted is actively supported by your Paysafe merchant account configuration. Next, ensure your API request is accurately mapping the card data so that the brand explicitly matches the PAN. If your gateway data construction is correct, prompt the customer to carefully re-enter their card details or provide an alternative, supported payment method before you retry the transaction.
For merchants
Review your checkout flow and API request construction to ensure card brand flags correctly align with the customer's inputted PAN. Check your Paysafe merchant account settings to confirm which card types are actively supported for your business. If the issue continues after verifying brand support and data validity, contact Paysafe technical support for deeper investigation.
For customers
Carefully check the credit or debit card number entered during checkout for any typos. If the number is correct, the specific card brand may not be supported by this store; please try a different card.