---
description: Understand the Square FAILED payment status. Learn why this terminal bank decline occurs, how to inspect the errors array, and when it is safe to retry.
title: Square Status FAILED: Payment Failed
image: https://cdn.smartretry.com/_next/static/media/og-image.0z0q4_5kazzzo.jpeg
---

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

Square · Status

# Square Status FAILED: Payment Failed

The payment request was declined or could not be processed. The seller receives no funds. This is a terminal state. Inspect the errors array for the specific reason.

## What it means

The FAILED status in Square indicates that a payment request was declined by the issuing bank or otherwise could not be processed. This is a terminal state, meaning the transaction authorization failed and the merchant will receive no funds. To understand exactly why the failure occurred, you must inspect the errors array associated with the transaction for the underlying decline code.

## Classification & retryability

hardsoftRetryable: conditional

Square does not automatically retry FAILED transactions. Because this top-level status encompasses both hard declines (e.g., lost card) and soft declines (e.g., insufficient funds), you should only initiate a retry after inspecting the specific error code in the errors array and confirming the root cause is temporary or correctable.

## Common causes

* The card-issuing bank declined the transaction due to insufficient funds in the customer's account.
* The customer provided incorrect payment details, such as a wrong expiration date or CVV.
* The issuing bank flagged the transaction as suspicious or detected potential fraud.
* The card used was previously reported as lost or stolen, resulting in a hard bank decline.

## How to resolve it

Because FAILED is a top-level terminal state, the exact resolution depends entirely on the underlying error. Parse the errors array returned in the Square API response to extract the specific decline code (such as GENERIC\_DECLINE). Once identified, determine if the error is temporary (like insufficient funds) or permanent (like a lost card). If permanent, do not retry the original payment method; if temporary, correct any data entry errors or allow time before re-attempting.

### For merchants

Inspect the API response's errors array to identify the specific decline reason. For subscription billing, ensure your own system handles the retry logic and customer communication, as Square will not automatically retry failed recurring payments. If the underlying cause is a hard decline or suspected fraud, block further retry attempts for that specific payment method.

### For customers

Verify that your payment details, including the card number, expiration date, and billing address, were entered correctly. If the information is correct and the payment continues to fail, contact your card-issuing bank for more details or provide an alternative payment method.

## Sources

* [Square Developer Platform (forum)](https://developer.squareup.com/forums/t/payment-status-detailed-information/17097)
* [Square Developer Platform (forum)](https://developer.squareup.com/forums/t/getting-alot-of-generic-decline-errors/14073)
* [Square Developer Platform (forum)](https://developer.squareup.com/forums/t/regarding-failed-subscription-payments/20855)
* [Square Help Center](https://squareup.com/help/us/en/article/5082-why-did-my-payment-fail)

---

```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":"Square","item":"https://www.smartretry.com/payment-providers/square"},{"@type":"ListItem","position":4,"name":"FAILED","item":"https://www.smartretry.com/decline-code/square-status-failed"}]}
```