Skip to main content

Square

Square Status failed: failed

soft decline

Last updated: November 19, 2026

Key details

Brand
Square
Code
FAILED
Category
Status
Response
Payment Failed
Detailed Response
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.
soft decline
This transaction is retriable

Payments failing with code FAILED are often recoverable with the right retry timing and routing. SmartRetry recovers up to 70% of soft declines with smart retries!

Actually, a big part of your declined transactions can be recovered

Recover your revenue >

What it means

In Square, the `failed` status indicates that the payment request was declined or could not be processed, and the seller receives no funds. This is a terminal state for that specific payment request. Because `failed` is a top-level status covering both temporary soft declines and permanent hard declines, you must inspect the `errors` array in the response to find the specific reason.

Why does code FAILED occur?

  • The customer's card issuer declined the payment request due to temporary issues like insufficient funds or a temporary issuer outage.
  • The card was declined due to incorrect card details entered, such as a wrong card number, CVV, or expiration date.
  • The issuer's automated systems or fraud rules blocked the transaction based on spending habits, location, or a lost or stolen card.

How to solve FAILED?

To resolve a `failed` payment status in Square, inspect the `errors` array returned in the API response to identify the underlying decline reason. If the underlying error is a soft decline, you can submit a new payment request later or ask the customer for an alternate payment method. If the `errors` array points to a hard decline or invalid card details, do not retry the same details; instead, ask the customer to verify their card information or provide a different payment method.

Solving as a merchant

Configure your integration to parse the `errors` array whenever a Square payment returns the `failed` status rather than treating all failed statuses identically. Route soft declines to an automated retry schedule as a new payment request, and suppress retries for hard declines while prompting the customer to update their payment method.

Solving as a client

Verify that the card number, expiration date, CVV, and address information were entered accurately. If the card details are correct, try an alternate payment method or contact the issuing bank directly, as card issuers only discuss the specifics of a decline with the cardholder.

Frequently asked questions about this topic

Share this article

Share on XShare on FacebookShare on LinkedIn
Kyle Regacho

Author

Kyle Regacho
LinkedInFind me on Linkedin

Focused on payment recovery, decline codes, and authorization optimization at SmartRetry. Helps payment teams turn failed transactions into recovered revenue

Read all articles >
View all
SmartRetry - Payment Recovery Platform

Decline codes tell you why. We fix it.

SmartRetry reads every decline reason and applies the right retry strategy for each one. Your recovery rate goes up without any changes to your payment provider.