Setting Up the Sandbox

Explore with AI

• Open in ChatGPT
• Open in Claude
• Copy for LLM
• View as Markdown
• Install Skills

Install Skills

Give your coding agents the context they need to build with Zoho Payments. View documentation

npx skills add https://www.zoho.com/payments/

Note: Skills-only installs don't receive automatic updates.
Run npx skills update -y to get the latest version.

Unless stated otherwise, all sandbox configuration steps mirror the production setup. The sections below document only the parameters that differ in the sandbox environment.

Obtaining Sandbox Credentials

To test in the sandbox, you will need a sandbox account and the corresponding credentials. Follow these steps:

1. Log in to the sandbox portal at https://paymentssandbox.zoho.in using your Zoho account.
2. Navigate to Settings and then Account Details to get your Account ID.
3. Register your application in the Zoho Developer Console to obtain a sandbox Client ID and Client Secret. Use these credentials when generating sandbox OAuth tokens.

Once done, you can proceed to configure OAuth for the Sandbox.

OAuth Configuration

OAuth configuration for the sandbox differs from production in just two parameters: the SOID and scope prefix. All other OAuth parameters remain unchanged from the live OAuth configuration.

When generating the authorization URL for the sandbox, update the following parameters in Step 2 of the OAuth flow to scope the authorization URL and generated tokens to your sandbox account.

1. SOID Parameter

Set the soid parameter using the sandbox prefix: zohopaysandbox.{account_id}

2. Scope Prefix

When specifying scopes, use the sandbox scope prefix: ZohoPaySandbox

ZohoPaySandbox.payments.CREATE

https://accounts.zoho.in/oauth/v2/org/auth?scope=ZohoPaySandbox.payments.CREATE,ZohoPaySandbox.payments.READ,ZohoPaySandbox.payments.UPDATE&client_id=1005xxxxxxxxxxxxxxxxxxxxxxxxx&soid=zohopaysandbox.8xxxxxxxx3&state=To generate payments access token&response_type=code&redirect_uri=https://www.zylker.com/&access_type=offline

Once you’ve configured OAuth for the sandbox, proceed to Testing Integration to set up the Widget, iOS SDK, and Android SDK for sandbox testing.