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.
| Environment | When to Use | Objects | How to Use | Considerations |
|---|---|---|---|---|
| Sandbox | While building and testing your integration. No real money is processed. |
Simulated objects: test payments, payment sessions, refunds, and webhook events. | - Use sandbox API credentials, sandbox OAuth scopes (ZohoPaySandbox.*), and sandbox endpoints. - Use test cards, UPI test amounts, and test bank names to simulate outcomes. |
- No real transactions occur. Settlements are not processed. Ensure is_test_mode = true for widget integration.- Ensure environment: .live (iOS) or ZohoPaymentsEnvironment.live (Android) for SDK integration. |
| Live (Production) | When ready to accept real payments from customers. | Real payment objects: live payments, refunds, settlements, and webhook events. | - Use live API credentials, production OAuth scopes (ZohoPay.*), and production endpoints. - Accept real cards, UPI, and Net Banking payments. |
- 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