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% |
- Online at 7.5% is at the upper edge of healthy. The 4, 8% range is normal CNP traffic; >8% triggers the alert.
- 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.
- 9 cancellations on Square Online. These are NOT in this card; they live in the cancel-rate metric. Most are 3DS abandons.
- 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 | The complement. |
squ_top_decline_reasons | The first card to open when this rate spikes. |
squ_threedsecure_abandon_rate | The cancel-side cousin metric (different fix). |
squ_top_payment_methods | Method mix shifts move blended decline. |
Stripe 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 |
stripe.stripe_decline_rate for the multi-rail view.
Known limitations / merchant FAQs
“Decline rate spiked overnight, what to check first?” Opensqu_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. 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.