Troubleshooting: Card Cannot Be Added in Square

If a card cannot be added or saved using the Square Widget, follow the steps below in order. In many cases, one of these checks will resolve the issue.

1. Verify the Billing Address and Postal Code

Confirm that the postal code entered exactly matches the billing postal code registered with the card issuer.

2. Check for a Reissued or Updated Card

Ensure that a newer version of the card has not been issued by the bank.
Cards that were replaced due to expiration, loss, fraud, or upgrades may keep the same card number but have updated expiration dates or security settings, which can cause older records to fail.

3. Confirm the Cardholder Name

Make sure the name entered matches the name on the card exactly.
This includes spelling, order, and the presence or absence of middle initials.

4. Ensure the Card Is Activated and Has Been Used

Verify that the card has been:

• Activated by the cardholder, and
• Successfully used at least once for a transaction

Some banks block card‑on‑file or online usage until an initial in‑person or approved transaction has occurred.

5. Validate International Card Compatibility

If the card was issued in another country, confirm that:

• The card supports international transactions, and
• The card network and issuing bank allow processing through Square

Not all international cards are supported, even if the card is otherwise valid.

6. Special Note for Corporate or Business Cards

For corporate or business-issued cards, double‑check with the bank that:

• “Save card on file” or recurring/card‑on‑file transactions are explicitly enabled

Many corporate cards have stricter controls by default that block stored payment methods.

If the Issue Persists

If repeated attempts fail:

1. Re‑confirm all steps above, and then
2. Contact the card issuer or bank directly to ask if the transaction or card‑on‑file request is being blocked on their end

Banks can often see the exact decline reason and resolve it faster than retries within Square.