Getting started¶

Use this page to pick the right product path and reach a first successful integration quickly.

Choose your product¶

• Web Integration: embed the Traveln trip planner widget or the Traveln SSO button widget on your website.
• Start here: Web integration overview
• Compare options: Widget Studio overview
• Build a full planner embed: Trip Planner Widget
• Build a redirect CTA: SSO Button Widget
• Mobile Integration: open the Traveln web app in a WebView with header-based silent login.
• Start here: Mobile integration overview
• APIs: call partner-facing Traveln APIs through the integrations host. /api/v1/ resource APIs use your SSO HMAC secret, while payment notifications use your partner API key.
• Start here: Integrations API overview

Environments at a glance¶

Traveln commonly runs across multiple hosts:

• docs host: this developer portal
• cdn host: widget loader scripts and tenant config JSON
• app host: the authenticated Traveln web app

What you need from Traveln¶

• Tenant slug (for web embeds and tenant-specific config)
• Partner API key (for mobile silent login headers and payment notifications, if applicable)
• SSO HMAC secret (for web server-side token signing and /api/v1/ resource API authentication)