Docs

Registering Domains for SDK Integration

Register all required domains for proper SDK functionality across environments.

To ensure the Grovs SDK works correctly across all environments, you must register every domain where the SDK will be used. This enables proper handling of callbacks, redirects, and security validation.

  • SDK Functionality -- The SDK uses registered domains to handle requests and callbacks correctly
  • Security -- Ensures the SDK only communicates with authorized endpoints
  • Environment Configuration -- Allows the SDK to adapt to different deployment environments

Register all domains, including localhost URLs for development. Missing domains will cause the SDK to fail in those environments.

1

Identify all environments

List every environment where your application is deployed or tested. Common environments include production, staging, test, and local development.

2

Collect full URLs

Gather the full URLs for each environment, including protocol (http or https) and port if applicable:

# Production
https://www.example.com
 
# Test
https://test.example.com
 
# Staging
https://staging.example.com
 
# Development
http://localhost:8080
http://localhost:3000
3

Log in to the Grovs dashboard

Open the Grovs dashboard and navigate to the domain registration section for your project.

4

Add each domain

Add each domain URL to your SDK configuration. Ensure that callback URLs and redirect URIs in your application match the registered domains exactly.

5

Verify registration

After registering domains, test the SDK integration in each environment:

Bash
# Test production
curl https://www.example.com/verify-sdk
 
# Test staging
curl https://staging.example.com/verify-sdk
 
# Test development
curl http://localhost:3000/verify-sdk

Confirm that the SDK initializes correctly and handles callbacks in all registered environments.

If you add new environments later, register their domains in the Grovs dashboard before deploying to those environments.