Zoho Invoice Integration
Automatically record crypto payments in Zoho Invoice. When a customer pays via Zyrox, the corresponding Zoho invoice is marked as paid.
How It Works
- Zyrox looks up the Zoho invoice by its number (the invoice ID from the payment URL)
- Records a customer payment via the Zoho Invoice API
- Zoho automatically marks the invoice as Paid
Invoice matching: The invoice ID in your payment URL (e.g.,
INV-0001) must match the invoice number in Zoho Invoice exactly.
Prerequisites
- A Zoho Invoice account with at least one organization
- A Zyrox merchant with wallet keys configured
- Access to the Zoho API Console to create API credentials
Setup Guide
Step 1: Create Zoho API Credentials
- Go to api-console.zoho.com
- Click Add Client → choose Self Client
- Copy your Client ID and Client Secret
- In the Self Client section, generate a code with scope:
ZohoInvoice.invoices.READ,ZohoInvoice.customerpayments.CREATE - Set the time duration to 10 minutes and click Create
Step 2: Configure in Zyrox Dashboard
- Go to Merchants → [Your Merchant] → Integrations
- Click Add Integration and select Zoho Invoice
- Enter your Client ID and Client Secret
- Paste the authorization code from Step 1 and click Exchange Code
- The system will automatically obtain a refresh token
- Enter your Organization ID (found in Zoho Invoice → Settings → Organization Profile)
⚠️ Important: The authorization code expires in 10 minutes. Complete the exchange promptly after generating it.
Step 3: Create Payment Links
For each Zoho invoice, create a payment URL using the Zoho invoice number as the invoice ID:
https://app.zyrox.io/pay/your-merchant/INV-0001?amount=150.00
When the customer pays, Zyrox will find INV-0001 in Zoho Invoice and automatically record the payment.
Configuration Fields
- Client ID — From Zoho API Console → Self Client. Used for OAuth authentication.
- Client Secret — From Zoho API Console → Self Client. Keep this value secret.
- Refresh Token — Obtained automatically via the code exchange process. Used to generate access tokens.
- Organization ID — Found in Zoho Invoice → Settings → Organization Profile. Identifies which Zoho organization to use.
Troubleshooting
"Zoho invoice not found"
The invoice number in the payment URL doesn't match any invoice in Zoho. Make sure the invoice ID in the URL exactly matches the Zoho invoice number (e.g., INV-0001).
"Code may have expired" The authorization code is valid for only 10 minutes. Generate a new code in the Zoho API Console and try the exchange again.
"OAuth refresh failed" The refresh token may have been revoked. Re-do the code exchange process to obtain a new refresh token.
Integration logs are available in Merchants → [Your Merchant] → Integration Logs. Check there for detailed request/response data when debugging issues.
© 2026 Zyrox. Simple and secure crypto payment processing.