// troubleshooting guide · zoho books
Zoho Books Online Payment Error (CP Codes)
- Status
- Workaround available
- platforms:
- Web
- updated:
- November 15, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · zoho-books/online-payment-error4 FIXES
// quick answer
When customers can't pay a Zoho Books invoice online, the CP error code tells you why: CP3002 means wrong gateway credentials, CP3004 address verification, CP4001 amount below the minimum, CP4003 unsupported currency. Fix the gateway setup under Settings > Integrations.
Most likely fix: Reconnect the gateway
How to fix it
// try these in order, the most common fix is first
FIX 1Reconnect the gateway
- 01Go to Settings > Integrations > Online Payments
- 02Re-enter the gateway credentials or reconnect Stripe
- 03Make sure the gateway is enabled on the invoice before sending
Did this fix it?FIX 2Fix address verification
- 01Go to Settings > Integrations > Card Verification Settings
- 02Enable the address fields so customers enter a billing address
Did this fix it?FIX 3Check amount and currency
- 01Make sure the amount due meets the gateway minimum
- 02Use a gateway that supports the invoice currency or change the invoice currency
Did this fix it?FIX 4Other codes
- 01CP1003: confirm the customer still exists
- 02CP3001: enable reference transactions in your merchant account
- 03CP3003: review fraud filters in the gateway dashboard
- 04CP3005: wait a few minutes between similar payments
Did this fix it?
Symptoms
Customer sees an error code when paying from the portal or invoice link, Pay with Stripe button does nothing, 'payment gateways have not been set up yet'.
Why it happens
- C-01CP1003: payment link tied to a deleted customer
- C-02CP3001: merchant account not enabled for reference transactions
- C-03CP3002: invalid gateway credentials or changed merchant account
- C-04CP3003: gateway fraud filters declined it
- C-05CP3004: address could not be verified
- C-06CP3005: similar payment within minutes
- C-07CP4001: amount below gateway minimum after discounts or credits
- C-08CP4003: gateway does not support the invoice currency
// this guide also covers
- zoho books payment gateway error
- zoho books stripe not working
- zoho books cp3002
- payment gateways have not been set up yet zoho
Still not working?
If Zoho Books keeps failing, you're not alone. See every Zoho Books problem users report or the alternatives people switch to.
Done fighting Zoho Books? Our small team builds your own Zoho Books alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usThe same problem in other apps
All not loading, error messages & connection guides →
QuickBooks Bank Error 102 and 105 (QuickBooks)
Xero File Upload Not Working (Xero)
FreshBooks Bank Connection Not Working (FreshBooks)
Wave Bank Connection Not Working (Wave)