## Zoho Payments Documentation Index

Access the complete documentation index at:
https://www.zoho.com/in/payments/llms.txt

Use this file to discover all available documentation pages before proceeding.

# Testing Web and Mobile Integrations

![](/payments/svg/cross.svg)

## Install Skills

Give your coding agents the context they need to build with Zoho Payments. [View documentation](/in/payments/developerdocs/agent-skills/)

`npx skills add https://www.zoho.com/payments/` ![](/payments/svg/copy-icon.svg)

**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.

*   [Web Integration](#Widget-Integration)
*   [Mobile Integration](#Mobile-Integration)
    *   [iOS SDK](#iOS-SDK)
    *   [Android SDK](#Android-SDK)

## Web Integration

When testing the payment widget in the sandbox, enable test mode by setting the following parameter during initialization. All other integration steps remain the same as in the [production widget documentation.](https://www.zoho.com/in/payments/developerdocs/web-integration/ "Widget Integration")

When testing the payment widget in the sandbox, you can simulate payment flows and verify integration, ensuring all interactions, callbacks, and events are handled safely.

Ensure the following parameter is set to enable sandbox mode: `otherOptions.is_test_mode = true`

* * *

## Mobile Integration

To test payments using the mobile SDKs, configure the environment to sandbox during initialization. This ensures all API calls, payment sessions, and events are routed through the test environment, allowing you to safely validate your integration without processing real transactions. All other SDK integration steps remain the same as in the production setup.

### iOS SDK

*   Minimum Version: **1.0.1+**
*   Specify the sandbox environment during initialization.
*   Embed the native iOS SDK to integrate payments into your iOS app using SwiftUI or UIKit. Refer to the [iOS developer doc](https://www.zoho.com/in/payments/developerdocs/iOS/ "iOS") for more details.
*   Repository: [GitHub - zpayments-ios-sdk](https://github.com/zoho/zpayments-ios-sdk "GitHub")

To Point to Sandbox

Copy

```javascript

`environment: .sandbox`
```

Request Example Sandbox

Copy

```javascript
widget = ZohoPaymentsCheckout(  
    apiKey: Secrets.apiKey,  
    accountId: Secrets.accId,  
    domain: .IN,  
    environment: .sandbox,  
    withCheckoutDelegate: self  
)
```

To Point to Live

Copy

```javascript

`environment: .live`
```

  

### Android SDK

*   Minimum Version: **1.0.2**
*   Set the environment parameter to `ZohoPaymentsEnvironment.sandbox` during initialization:
*   Add the Zoho Payments Android SDK to your project and app build.gradle files. Refer to the [Android developer doc](https://www.zoho.com/in/payments/developerdocs/android/ "Android") for more details.

To Point to Sandbox

Copy

```javascript
`ZohoPaymentsEnvironment.sandbox`
```

Request Example Sandbox

Copy

```javascript
CheckoutSDK.showCheckout(  
    this,  
    options,  
    ZohoPayDomain.IN,  
    environment = ZohoPaymentsEnvironment.sandbox,  
    object : ZohoPayCheckoutCallback {  
        override fun onPaymentSuccess(paymentId: String, signature: String) {  
            // Handle success  
        }  
        override fun onPaymentFailure(error: String) {  
            // Handle failure  
        }  
    }  
)
```

To Point to Live

Copy

```javascript

`ZohoPaymentsEnvironment.live`
```