Testing Web and Mobile Integrations

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.

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.

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 for more details.
• Repository: GitHub - zpayments-ios-sdk

`environment: .sandbox`

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

`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 for more details.

`ZohoPaymentsEnvironment.sandbox`

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  
        }  
    }  
)

`ZohoPaymentsEnvironment.live`