Troubleshooting Guide · SideGuy · 2026

Payment Rail Troubleshooting

Payments getting declined, stuck, or disappearing? This guide covers failure diagnosis across Stripe, Square, ACH, and peer-to-peer rails — with specific fix steps for each.

Common Failures by Rail

Stripe

Card declines, webhook delivery failures, payout delays, dispute handling, radar false positives blocking real customers.

Square

Reader connectivity issues, keyed-entry failures, transfer timing gaps, Square Online checkout errors.

ACH / Bank Transfer

R-code returns (R01–R10), 2–5 day settlement delays, micro-deposit verification timeouts, Plaid connection errors.

Venmo / PayPal

Account limits, business vs personal rail confusion, hold periods for new accounts, chargeback exposure on goods/services payments.

Stripe Decline Codes — What They Mean & What to Do

Code	Meaning	Action
`card_declined`	Generic decline — bank refused	Ask customer to call bank or use different card
`insufficient_funds`	Balance too low	Offer payment plan or retry later
`do_not_honor`	Bank blocked — often fraud flag	Customer must call bank to authorize
`expired_card`	Card expiration date passed	Collect new card details
`incorrect_cvc`	CVV mismatch	Re-enter CVV — 3 failures may lock card
`fraudulent`	Stripe Radar flagged this charge	Review Radar rule that triggered, whitelist if legitimate
`authentication_required`	3D Secure required by bank	Enable `payment_intent` with 3DS — don't charge without it

Stripe Payout Delays

New Stripe accounts default to 7-day rolling payouts. Verify 2 successful charge cycles to unlock faster schedules (typically 2-day).
Payout paused? Check Dashboard → Balance → "Payouts paused" notice — usually a verification document request that expired.
Manual payout schedule vs automatic: Settings → Payouts → if set to manual, payouts only happen when you click "Pay out" — easy to miss.

ACH Return Codes (R-Codes) — Fast Reference

Code	Meaning	Retryable?	Action
R01	Insufficient funds	Yes	Retry after 3–5 days
R02	Account closed	No	Collect new bank info
R03	No account / unable to locate	No	Verify routing + account number
R04	Invalid account number	No	Collect correct account number
R07	Authorization revoked by customer	No	Stop charging — customer opted out
R10	Customer advises not authorized	No	Dispute — gather your authorization record
R29	Corporate customer advises not authorized	No	Stop charging — escalate to finance

Universal Troubleshooting Patterns

Always check your payment processor's status page before deep-diving — many "failures" are upstream provider incidents (Visa/Mastercard networks, card.io, etc.).
Log the full error object, not just the message. error.code, error.decline_code, and error.charge each tell a different part of the story.
Implement idempotency keys on every charge attempt — prevents double-charges when your retry logic fires more than once.
For recurring billing: set up dunning logic (smart retry schedule). Stripe's Smart Retries use ML to pick optimal retry timing — enable it in Billing settings.
Never show raw decline codes to users. Map them to friendly messages: "Insufficient funds" → "Your card was declined. Please try a different payment method."
For ACH: validate bank details via Plaid or microdeposits before your first charge — catching R03/R04 early prevents ACH return fees (~$5–15 each).
Keep dispute win rate above 60% — below that, processors increase monitoring and may restrict your account. Respond to every dispute within 7 days with documentation.

Frequently Asked Questions

A customer's card worked last week but declines now — what happened?

Most likely: bank issued a new card (reissue after data breach), card expired, or fraud department added a block. Ask the customer to check their bank app for a notification — often they just need to approve the transaction from their mobile banking app.

My Stripe payouts are delayed and I need cash now — what are my options?

Stripe Instant Payouts let you transfer to a debit card within 30 minutes for a 1% fee (min $0.50). Available if your account is verified and in good standing. Go to Dashboard → Balance → Instant payout.

Payment went through but money never hit my bank — where is it?

Check four places: (1) Stripe/Square Balance vs Available Balance — funds may be "available soon" not yet transferable. (2) Payout schedule — if weekly, money batches on a specific day. (3) Bank processing time — even after a Stripe payout initiates, ACH takes 1–2 business days. (4) Payout method — confirm correct bank account in settings.

Can I use Venmo for business payments and is it reliable?

Venmo Business profiles work for services and products, but have $2,499.99/week receiving limits and 1.9% + $0.10 fee on business transactions. Personal Venmo for business is against TOS and risks account freeze. For volume above $5K/month, use Stripe or Square.

Need help diagnosing a payment failure right now?

Text PJ at +1 (858) 461-8054. Send the processor (Stripe/Square/ACH), the error code or message, and the amount. Payment rail diagnosis is usually fast — most failures have a specific and fixable cause.

Payment stuck or failing?

Text PJ the processor and error. Most payment rail issues are diagnosed in one session — no retainer required.

💬 Text PJ Now 💙 Venmo PJ Stripe vs Square →