Environment Setup
This section covers the essentials you need before starting your SDK integration: environment URLs, credentials, and the SDK URL format.
Understand the Environments
Hubble provides two separate environments. You will start on Staging for development and testing, and move to Production after your integration is verified by the Hubble team.
| Environment | SDK Base URL | Purpose |
|---|---|---|
| Staging | https://sdk.dev.myhubble.money/ | Testing and development |
| Production | https://sdk.myhubble.money/ | Live users with real transactions |
Staging credentials will not work on the production URL, and vice versa. This will cause authentication failures. Always ensure your clientId, appSecret, and base URL all belong to the same environment.
Get Your Staging Credentials
Use the integration portal to obtain your:
- clientId — Your unique partner identifier
- appSecret — Your application secret (used in the SDK URL)
You will receive staging credentials first. Production credentials are provided separately by Hubble after your staging integration is verified.
Understand the SDK URL Format
The Hubble SDK is a hosted web application. You embed it in your app by loading a URL. Every SDK URL follows this format:
https://sdk.dev.myhubble.money/
?clientId=YOUR_CLIENT_ID
&appSecret=YOUR_APP_SECRET
&token=USER_SSO_TOKEN
| Parameter | Description |
|---|---|
clientId | Your unique partner identifier, provided by Hubble |
appSecret | Your application secret, provided by Hubble |
token | A per-session SSO token that identifies the current user (see Authentication) |
The appSecret in the SDK URL is not a traditional API secret. It is a client identifier used alongside clientId to load the correct SDK configuration. It does not grant access to any backend APIs, cannot initiate transactions on its own, and cannot be used to read or modify data. The appSecret is safe to include in client-side code.
Optional URL Parameters
| Parameter | Required | Description |
|---|---|---|
clientId | Required | Client ID provided by the Hubble team during onboarding |
appSecret | Required | App secret provided by the Hubble team (used for server-side config lookup) |
token | Required | SSO token for the current user, generated by your backend |
appVersion | Optional | App version string. Defaults to "10000". |
deviceId | Optional | Device identifier for analytics tracking. |
Next Steps
Once you have your credentials and understand the URL format:
- Set up authentication — Configure SSO to authenticate users
- Choose your platform — Set up the SDK on Web, Android, iOS, React Native, or Flutter