> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Decline Rate, Square

> Decline Rate for Square stores. Tracked live in Vortex IQ Nerve Centre. How to read it, why it matters, and how to act on it.

**Metrics type:** [Supporting Metrics](/nerve-centre/overview#metrics-types-explained)  •  **Category:** [Payment Gateway](/nerve-centre/connectors#connectors-by-type)

## At a glance

> Percentage of attempted Square payments that **failed** (issuer-declined, fraud-flagged, terminal-rejected). The complement of success rate. POS card-present declines are rare (\<1%); Square Online declines run 4, 8% on healthy traffic. Spikes signal issuer-side fraud filters, BIN-range issues, 3DS friction, or terminal hardware problems.

|                            |                                                                                                                                                                                    |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **What it counts**         | `COUNT(status = FAILED) / COUNT(status IN (COMPLETED, FAILED, CANCELED)) * 100`. `CANCELED` (customer abandoned, e.g. 3DS abandon) excluded from numerator and tracked separately. |
| **API endpoint**           | `/v2/payments` with full status enumeration.                                                                                                                                       |
| **Currency**               | Currency-neutral.                                                                                                                                                                  |
| **Channel split**          | POS \<1%; Online 4, 8%; Cash App Pay 2, 5%. Blended rate depends on channel mix.                                                                                                   |
| **3DS abandon vs decline** | A 3DS challenge the issuer rejected = `FAILED` (decline). A 3DS challenge the customer abandoned = `CANCELED`. Different fixes.                                                    |
| **Time window**            | `7D vsP`.                                                                                                                                                                          |
| **Alert trigger**          | `>8%` absolute, OR `+25%` relative spike vs prior week. Sentiment inverse-gauge: good \<=5, warn >=8.                                                                              |
| **Roles**                  | owner, finance, operations                                                                                                                                                         |

## Calculation

Calculated automatically from your Square data. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading.

## Worked example

7-day window for a US Square merchant running POS + Online:

| Channel              | Successful | Failed | Cancelled | Decline rate         |
| -------------------- | ---------- | ------ | --------- | -------------------- |
| POS chip + tap       | 1,420      | 8      | 1         | 8 / 1,429 = **0.6%** |
| Square Online        | 287        | 24     | 9         | 24 / 320 = **7.5%**  |
| Cash App Pay         | 41         | 1      | 0         | 1 / 42 = **2.4%**    |
| Apple/Google Pay POS | 92         | 1      | 0         | 1 / 93 = **1.1%**    |

```text theme={null}
Blended decline rate = 34 / 1,884 = 1.8%
```

Reads:

1. **Online at 7.5% is at the upper edge of healthy.** The 4, 8% range is normal CNP traffic; >8% triggers the alert.
2. **POS at 0.6% is very healthy.** Card-present declines are nearly always genuine (insufficient funds, lost / stolen, expired). Above 2% suggests terminal connectivity or a chip-reader fault.
3. **9 cancellations on Square Online.** These are NOT in this card; they live in the cancel-rate metric. Most are 3DS abandons.
4. **Cash App Pay at 2.4% is high for that channel.** Block's filters are typically tight.

## Sibling cards merchants should reference together

| Card                                                                                   | Why pair                                       |
| -------------------------------------------------------------------------------------- | ---------------------------------------------- |
| [`squ_success_rate`](/nerve-centre/kpi-cards/square/success-rate)                      | The complement.                                |
| [`squ_top_decline_reasons`](/nerve-centre/kpi-cards/square/top-decline-reasons)        | The first card to open when this rate spikes.  |
| [`squ_threedsecure_abandon_rate`](/nerve-centre/kpi-cards/square/3ds-abandonment-rate) | The cancel-side cousin metric (different fix). |
| [`squ_top_payment_methods`](/nerve-centre/kpi-cards/square/top-payment-methods)        | Method mix shifts move blended decline.        |
| Stripe [`stripe_decline_rate`](/nerve-centre/kpi-cards/stripe/decline-rate)            | Cross-PSP comparison.                          |

## Reconciling against the vendor's own dashboard

**Where to look in the Square Dashboard:**

> **Reports → Transactions** with status filter "Failed". Compare the count to the same window's "Completed" count.

**Common divergences:**

| Reason              | Direction                                                              |
| ------------------- | ---------------------------------------------------------------------- |
| Cancelled inclusion | Some Dashboard tiles fold cancels into declines; this card splits them |
| Time zone           | Boundary days                                                          |
| 3DS late-flip       | Challenge resolved hours later; flips Failed→Completed retroactively   |

**Cross-connector reconciliation:** Stripe and Square decline rates for the same business diverge typically by 1, 3pp due to acquirer routing differences. Compare [`stripe.stripe_decline_rate`](/nerve-centre/kpi-cards/stripe/decline-rate) for the multi-rail view.

## Known limitations / merchant FAQs

**"Decline rate spiked overnight, what to check first?"**
Open [`squ_top_decline_reasons`](/nerve-centre/kpi-cards/square/top-decline-reasons). Common patterns: (1) issuer-side fraud filter wave (cluster of `CARD_DECLINED` from one BIN), (2) bad-traffic ad campaign, (3) Square Risk tightened.

**"POS decline rate at 3%, why?"**
Above 2% on POS is a hardware or connectivity flag. Likely candidates: chip reader needs replacement, Wi-Fi unstable at the till, NFC antenna interference.

**"Are 3DS abandonments declines?"**
No. 3DS-abandon is `CANCELED` and tracked in [`squ_threedsecure_abandon_rate`](/nerve-centre/kpi-cards/square/3ds-abandonment-rate). Issuer-rejected 3DS challenges are `FAILED` and count here.

**"My subscription rebill failures, do those count?"**
Yes. Each failed rebill is one decline. Square Subscriptions retries over 3, 7 days; recoveries flip to `COMPLETED` and stop counting.

**"Why is Square Online decline higher than my chip + tap?"**
CNP has more issuer + 3DS + Square Risk evaluation. CP is mostly procedural. The 5, 8 percentage point gap is universal.

**"Cash App Pay declines, do those have unique reasons?"**
Yes. Insufficient Cash App balance, expired linked card, Block buyer-side risk decline.

**"My multi-location merchant has very different rates per location, normal?"**
Yes. Locations in different states or different demographics see different traffic quality.

***

### Tracked live in Vortex IQ Nerve Centre

*Decline Rate* is one of hundreds of KPI pulses Vortex IQ tracks across Square and 70+ other ecommerce connectors. Nerve Centre runs the detection layer; Vortex Mind investigates the cause when something moves; Ask Viq lets you interrogate any number in plain English.

[Start for free](https://app.vortexiq.ai/login) or [book a demo](https://www.vortexiq.ai/contact-us) to see this metric running on your own data.