Environments

Environment URLs

Environment Detection

The SDK auto-detects its environment from the script URL hostname — there is no environment config parameter.

VisaAcceptance.getEnvironment();
// Returns: 'local' | 'dev' | 'cte' | 'prod'

Detection rules:

• local.sdk.embed.visa.com or localhost → 'local'
• dev.sdk.embed.visa.com → 'dev'
• cte.sdk.embed.visa.com → 'cte'
• sdk.embed.visa.com (no prefix) → 'prod'

Version Pinning

Pin to a specific SDK version using the ?tag= query parameter:

<script src="https://sdk.embed.visa.com/acceptance/v1?tag=2.1.0"></script>

Without a tag, you get the latest stable release for that major version channel.

Branch Previews

Branch-specific builds are available in the dev environment:

<script src="https://dev.sdk.embed.visa.com/branch/feature-alice/sdk/v1"></script>

The SDK automatically routes to the matching branch components on the runtime domain.

Local Development

Run the embed-host locally:

nx serve embed-host

The local runtime serves on https://local.runtime.embed.visa.com:8081. Add the local SDK script tag to your page:

<script src="https://local.sdk.embed.visa.com:8081/acceptance/v1"></script>

CORS / Origin Allowlist

Each environment has a registered set of allowed origins. To add your domain:

1. Contact Visa Acceptance Platform team
2. Provide the exact origin(s) that will embed components
3. Origins are registered per-environment (dev/cte/prod separately)