---
description: Paysafe error code 3002 indicates an invalid card number, unsupported brand, or mismatched brand-to-PAN combo was submitted. Learn how to resolve it.
title: Paysafe Error Code 3002: Invalid Card Number or Brand
image: https://cdn.smartretry.com/_next/static/media/og-image.0z0q4_5kazzzo.jpeg
---

[Skip to main content](#main-content)

Paysafe · Error Code

# 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

technicalhardRetryable: conditional

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.

## Sources

* [Paysafe Developer – Card Errors (Cards API)](https://developer.paysafe.com/en/api-docs/payments-api/add-payment-methods/cards/card-errors/)
* [Paysafe Developer – Web Services Credit Card Errors Troubleshooter (PDF)](https://developer.paysafe.com/fileadmin/content/pdfs/Error%5FTroubleshooting%5FCC%5FWS.pdf)

---

```json
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://www.smartretry.com/"},{"@type":"ListItem","position":2,"name":"Decline Code","item":"https://www.smartretry.com/decline-code"},{"@type":"ListItem","position":3,"name":"Paysafe","item":"https://www.smartretry.com/payment-providers/paysafe-group"},{"@type":"ListItem","position":4,"name":"3002","item":"https://www.smartretry.com/decline-code/paysafe-group-error-code-3002"}]}
```