// 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
Share

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

  1. FIX 1Reconnect the gateway

    1. 01Go to Settings > Integrations > Online Payments
    2. 02Re-enter the gateway credentials or reconnect Stripe
    3. 03Make sure the gateway is enabled on the invoice before sending
    Did this fix it?
  2. FIX 2Fix address verification

    1. 01Go to Settings > Integrations > Card Verification Settings
    2. 02Enable the address fields so customers enter a billing address
    Did this fix it?
  3. FIX 3Check amount and currency

    1. 01Make sure the amount due meets the gateway minimum
    2. 02Use a gateway that supports the invoice currency or change the invoice currency
    Did this fix it?
  4. FIX 4Other codes

    1. 01CP1003: confirm the customer still exists
    2. 02CP3001: enable reference transactions in your merchant account
    3. 03CP3003: review fraud filters in the gateway dashboard
    4. 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 us

Watch Zoho Books Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Zoho Books errors