Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

More of my customers' card payments are being declined on Square

Short answer

Square says it is not given an exact reason a card is declined, so most declines come from the card issuer. Square's own list of seller-side causes is short: wrong details typed in, an out-of-date billing ZIP code, a non-Gregorian calendar on an Apple device, and a weak or lost connection. Check those, then outages.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • More cards are declining than a month ago.
  • Cards that work elsewhere decline on my reader or website.
  • Declines come in bursts on one device or at one location.
  • Payments taken offline later turned out to be declined.
  • A customer was charged on their statement but I see no sale.

Why does this happen?

  1. Square does not get the reason

    Square's troubleshooting article states that Square is not given an exact reason a card is declined. If the customer has confirmed their card is valid, it advises them to contact their card-issuing bank.

  2. Hand-typed details must match exactly

    Square says that for manually entered cards, the card number, expiry, security code and ZIP must match the card exactly. A billing ZIP code that is out of date, for a customer who moved, can cause a decline.

  3. A wrong calendar on an Apple device

    Square lists a non-Gregorian calendar setting on a compatible Apple device as a cause of declined cards. Its fix is to set the calendar to Gregorian and sign out of and back into the Square app.

  4. A poor connection and offline payments

    Square needs an active internet connection, and an incoming call or text can interrupt a payment in the app. Square says declines are not retried unless the device is forced offline. Offline payments must be uploaded when you reconnect, and signing out or deleting the app meanwhile can permanently lose them.

  5. A cancelled payment can leave a hold

    Square explains that an interrupted or declined payment can leave a pending charge on the customer's statement that does not appear in your Square payment history. Square sends a void notification to the bank, which usually takes a few business days to release the hold.

What can I do about it today?

  1. Look for a patternIs it one device, one location, one card type or one time of day? A pattern points to a cause on your side.
  2. Check the Apple device calendarOn an iPhone or iPad used for Square, set the calendar to Gregorian, then sign out and back into the app.
  3. Check the internet connectionSquare says it needs a working Wi-Fi or mobile connection. Try the payment again on a stable network.
  4. Check Square's status pageIf all card payments decline while the device is online, Square points to issquareup.com for outages.
  5. Do not sign out while offline payments are waitingSquare warns this can lose them permanently. Reconnect first and let them upload.
  6. Ask the customer to contact their bankIf the card is valid and keeps declining, only the issuing bank can say why.

When should I bring someone in?

  • Declines persist on every device and card type even though Square shows no outage.
  • Your website's Square checkout declines, but the reader works, or the other way round.
  • You see a big drop in successful payments and cannot find a cause.

How do I handle it?

  1. Separate your side from the bank's sideI compare declines by device, channel, card brand and time to see whether the pattern is on your side or spread evenly.
  2. Check how your website sends the paymentFor online payments, I read how the site passes card details and billing data to Square, and whether any field is missing or malformed.
  3. Reproduce with a testI run the same flow in Square's sandbox to see whether the integration itself fails.
  4. Write a clear message to SquareIf it still looks unexplained, I prepare the dates, payment IDs and examples for Square support.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Can Square tell me why a card was declined?

Square says it is not given an exact reason. The customer should contact their card issuer.

Why is a customer charged but I see no sale?

Square says a cancelled, interrupted or declined payment can leave a pending charge, which the bank releases after Square sends a void notice. It usually takes a few business days.

How do I confirm a payment really went through?

Square suggests the payment notification email, the Transactions page, or the Transaction status report.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.