Zoho Books and Stripe integration

What moves between them

Customer and invoice data flows from Zoho Books to Stripe. When a new Contact is created or updated in Zoho Books, ml-connector creates or updates a corresponding customer in Stripe with the contact name, email, and address. When an Invoice is issued in Zoho Books, ml-connector creates a matching invoice object in Stripe with line items, amounts in the correct currency, and customer reference. Zoho Books uses webhooks to push customer and invoice events; ml-connector can also poll on a schedule if webhooks are not enabled. The sync is one-directional from Zoho Books to Stripe because Stripe is payment-collection-only and has no purchase orders, vendor payments, or chart of accounts.

How ml-connector handles it

ml-connector stores Zoho Books OAuth2 credentials encrypted (client_id, client_secret, refresh_token) and refreshes the access token before it expires at 1 hour. When calling Zoho Books endpoints, ml-connector includes the organization ID query parameter and routes to the correct regional base URL stored in the credential. For each Contact or Invoice received via webhook or polling, ml-connector maps Zoho Books entity fields to Stripe customer and invoice field names, converts multi-currency amounts to the Stripe currency using the exchange_rate from Zoho Books, and sends the POST request to Stripe with the secret API key in HTTP Basic Auth. Stripe's form-encoded payloads require parameter conversion (Zoho Books JSON arrays map to Stripe's indexed form parameters: invoice_items[0][description], invoice_items[0][amount]). When Zoho Books webhook rates hit the 100-request-per-minute limit, ml-connector backs off and retries. Every record carries full audit trail with webhook event ID or polling checkpoint, and can be replayed if a Stripe call fails.

A real-world example

A mid-sized SaaS company runs Zoho Books for accounting across multiple countries, managing invoices in USD, EUR, and GBP. Previously, the finance team manually exported invoices from Zoho Books and re-entered them into Stripe for payment processing each day, a bottleneck that delayed customer payment collection and created reconciliation headaches at month-end. With Zoho Books and Stripe connected, invoices flow automatically to Stripe in the correct currency immediately after issue, customers receive payment links instantly, and the finance team no longer spends time on manual data entry.

What you can do

• •Create and update Stripe customers from Zoho Books Contacts, with email, name, and address.
• •Push Zoho Books invoices to Stripe with all line items, multi-currency amounts, and customer reference.
• •Map Zoho Books currencies to Stripe amounts, converting via the recorded exchange rate.
• •Receive invoice and contact changes via Zoho Books webhooks or poll on a schedule, with full retry and audit.
• •Handle Zoho Books regional base URL routing and organization ID requirements, and Stripe form-encoded payloads.

Questions

Which direction does data move between Zoho Books and Stripe?

Data flows from Zoho Books to Stripe. Customers and invoices created in Zoho Books are synced to Stripe for payment processing. Stripe is payment-only and does not have purchase orders, bills, or general ledger accounts, so the sync does not move data back into Zoho Books. Payment status in Stripe can be recorded separately in Zoho Books if needed via a second flow.

How does the integration handle Zoho Books multi-currency and regional endpoints?

Zoho Books returns a region field in the OAuth2 token response that indicates which regional base URL to use (US, EU, India, Australia, Japan, Canada, China, Saudi Arabia). ml-connector stores this region credential and routes all calls to the correct endpoint. For multi-currency amounts, ml-connector pulls the currency_id and exchange_rate from each Zoho Books invoice and converts the amounts to Stripe's currency using that rate.

Does the integration use webhooks or polling?

Zoho Books supports outgoing webhooks for invoices and contacts with HMAC signature verification. ml-connector can listen for webhook events and sync immediately, or poll the Zoho Books list endpoints on a schedule if webhooks are not configured. Both approaches are supported; webhook delivery is faster but polling is more reliable for customers with intermittent webhook delivery.