Sandbox
The Zoho Payments Sandbox is a test environment that lets you build and validate your payment integration without processing real transactions or affecting live data. The sandbox mirrors the production environment in behaviour, but all transactions are simulated, no money moves, no settlements are processed, and no live credentials are required.
Note: Contact support to enable Zoho Payments Sandbox.
Use the sandbox to validate the following before going live:
- OAuth authorization flows
- Payment widget integration
- iOS and Android mobile SDK implementation
- Webhook event handling
- Transaction success, failure, and refund scenarios
You can access the sandbox portal at: https://paymentssandbox.zoho.in/
Insight: You can invite users to your Sandbox org to test out features and payment workflows.
Sandbox vs Live Environment
All Zoho Payments API requests are executed in either the Sandbox or Live (Production) environment. Here are some differences:
Note: The sandbox environment is completely isolated from production. Objects created in the sandbox, including payment sessions, payments, and refunds cannot be referenced or used in the live environment, and vice versa.
| Aspect | Sandbox | Live (Production) |
|---|---|---|
| When to Use | While building and testing your integration. No real money is processed. |
When ready to accept real payments from customers. |
| Objects | Simulated objects: test payments, payment sessions, refunds, and webhook events. | Real payment objects: live payments, refunds, settlements, and webhook events. |
| How to Use | - Use sandbox API credentials, sandbox OAuth scopes (ZohoPaySandbox.*), and the sandbox endpoint: https://paymentssandbox.zoho.in/. - Use test cards, UPI test amounts, and test bank names to simulate outcomes. |
- Use live API credentials, production OAuth scopes (ZohoPay.*), and the production endpoint: https://payments.zoho.in/. - Accept real cards, UPI, and Net Banking payments. |
| Considerations | - No real transactions occur. Settlements are not processed. Ensure is_test_mode = true for widget integration.- Ensure environment:.sandbox (iOS) or ZohoPaymentsEnvironment.sandbox (Android) for SDK integration. |
- Real transactions are processed and settled to your verified bank account. - Ensure webhooks, signature verification, and settlement accounts are properly configured before going live. |
Walkthrough of Zoho Payments personalized to your business needs