{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Hubby Native eSIM Integration","description":"Integrate Hubby eSIM into your travel platform with our comprehensive API documentation, tutorials, and guides.","keywords":"hubby, esim, api, travel, integration, documentation"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"hubby-native-esim-integration"},"children":["Hubby Native eSIM Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Native eSIM Integration lets you build a fully custom eSIM experience inside your native mobile app. Your backend communicates with Hubby server-to-server. All telco complexity — eSIM provisioning, package management, universal eSIM lifecycle — is abstracted away. You build the UI and control the payment flow; Hubby provides the data, provisioning engine, and event system."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page covers the complete flow: every API call in sequence, what you render at each step, installation credentials, AI-powered instructions, and how to monitor usage."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WebView or Native?"]}," Most partners start with the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/webview"},"children":["Hubby WebView"]}," — go live in days with zero frontend work. The Native eSIM Integration is for partners who need full UI control. Both can coexist: start with the WebView and selectively move high-traffic screens (data meter, top-up) to native over time."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-build-vs.-what-hubby-handles"},"children":["What You Build vs. What Hubby Handles"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Your team"},"children":["Your team"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Hubby"},"children":["Hubby"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All UI screens (installation, data meter, top-up store, package selection)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Package provisioning, eSIM assignment, region optimization"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Backend calls to Hubby API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Universal eSIM lifecycle (one eSIM per traveler, packages queue)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment processing (you are Merchant of Record)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["B2B net rate invoicing, B2C price recommendations"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Push notifications mapped to webhook events"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Webhook delivery, departure-time CRM triggers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Installation flow using credentials from Hubby"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AI-powered installation instructions per device/OS"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Support UI (Intercom SDK or your own)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AI + human support team (< 3 min first response)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"architecture"},"children":["Architecture"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"sequenceDiagram\n participant App as Partner App
(Native UI)\n participant PB as Partner Backend\n participant API as Hubby API\n\n PB->>API: POST /api/bookings\n API-->>PB: booking confirmation + package IDs\n\n PB->>API: GET /api/native/user-dashboard?external_user_id=...\n API-->>PB: user + package queues + eSIM + packages + partner\n\n PB->>App: Render UI based on user state\n\n App->>PB: User taps \"Install eSIM\"\n PB->>API: POST /api/native/instructions\n API-->>PB: Device-specific installation steps\n\n App->>PB: User taps \"Redeem package\"\n PB->>API: POST /api/native/redeem-package\n API-->>PB: Package redeemed + eSIM updated\n\n Note over API,PB: Webhooks push real-time events\n API-->>PB: package.usage.80_percent\n PB->>App: Push notification: \"Running low on data\"\n\n App->>PB: User taps \"Buy more data\"\n PB->>API: POST /api/bookings (same external_user_id)\n API-->>PB: New package queued on existing eSIM\n","diagramHtml":"
Hubby APIPartner BackendPartner App(Native UI)Hubby APIPartner BackendPartner App(Native UI)Webhooks push real-time eventsPOST /api/bookingsbooking confirmation + package IDsGET /api/native/user-dashboard?external_user_id=...user + package queues + eSIM + packages + partnerRender UI based on user stateUser taps \"Install eSIM\"POST /api/native/instructionsDevice-specific installation stepsUser taps \"Redeem package\"POST /api/native/redeem-packagePackage redeemed + eSIM updatedpackage.usage.80_percentPush notification: \"Running low on data\"User taps \"Buy more data\"POST /api/bookings (same external_user_id)New package queued on existing eSIM
"},"children":["sequenceDiagram\n participant App as Partner App
(Native UI)\n participant PB as Partner Backend\n participant API as Hubby API\n\n PB->>API: POST /api/bookings\n API-->>PB: booking confirmation + package IDs\n\n PB->>API: GET /api/native/user-dashboard?external_user_id=...\n API-->>PB: user + package queues + eSIM + packages + partner\n\n PB->>App: Render UI based on user state\n\n App->>PB: User taps \"Install eSIM\"\n PB->>API: POST /api/native/instructions\n API-->>PB: Device-specific installation steps\n\n App->>PB: User taps \"Redeem package\"\n PB->>API: POST /api/native/redeem-package\n API-->>PB: Package redeemed + eSIM updated\n\n Note over API,PB: Webhooks push real-time events\n API-->>PB: package.usage.80_percent\n PB->>App: Push notification: \"Running low on data\"\n\n App->>PB: User taps \"Buy more data\"\n PB->>API: POST /api/bookings (same external_user_id)\n API-->>PB: New package queued on existing eSIM\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-full-flow"},"children":["The Full Flow"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1--create-a-booking"},"children":["Step 1 — Create a Booking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/bookings"]}]}," — identical to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/webview#step-1--create-a-booking"},"children":["WebView flow"]},". Your backend calls this when a traveler qualifies for a package."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n 'https://api.hubbyesim.com/api/bookings' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1717689600000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"departure_date\": \"2026-07-15T14:30:00+02:00\",\n \"locale\": \"es\",\n \"package_specifications\": [\n {\n \"external_user_id\": \"partner_user_456\",\n \"destination\": \"GR\",\n \"size\": \"1GB\"\n }\n ]\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"success\": true,\n \"data\": {\n \"id\": \"booking_abc\",\n \"package_specifications\": [\n {\n \"external_user_id\": \"partner_user_456\",\n \"package_id\": \"pkg_xyz\",\n \"destination\": \"GR\",\n \"size\": \"1GB\",\n \"status\": \"provisioned\"\n }\n ]\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You specify ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["destination + size"]}," (not a package ID). Hubby auto-routes to the optimal package. Multi-destination bookings are automatically optimized — a trip to Greenland, Canada, the US, and Mexico may be fulfilled with a North America regional package plus individual packages."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]}," is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}," for the Native eSIM Integration. It must be your own stable user identifier — the same value is used across all ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/native/*"]}," endpoints (dashboard, redeem, instructions). Do not supply this field if you are not using the Native eSIM Integration or the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/webview"},"children":["Hubby WebView"]}," — it is ignored in the traditional booking flow and supplying it incorrectly will route the package into the eSIM management flow."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2--fetch-user-dashboard"},"children":["Step 2 — Fetch User Dashboard"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/native/user-dashboard?external_user_id=..."]}]}," — the central endpoint for the Native eSIM Integration. One call returns everything you need to render any screen: user info, pending package queues, current eSIM state, active eSIM packages, and partner details."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n 'https://api.hubbyesim.com/api/native/user-dashboard?external_user_id=user_abc123' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1711200000000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"success\": true,\n \"data\": {\n \"user\": {\n \"id\": \"firestore-user-id\",\n \"external_user_id\": \"user_abc123\",\n \"has_universal_esim\": true,\n \"current_universal_esim\": \"8901234567890123456\"\n },\n \"package_queues\": [\n {\n \"id\": \"pq_xyz789\",\n \"uuid\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"type\": \"booking\",\n \"package_specification\": {\n \"iso3\": \"FRA\",\n \"bytes\": 1073741824,\n \"duration_days\": 30\n },\n \"created_at\": \"2026-03-20T10:00:00.000Z\",\n \"redeemed_at\": null\n }\n ],\n \"current_esim\": {\n \"provider\": \"esim-provider\",\n \"name\": \"Hubby Universal ESIM\",\n \"qr\": \"LPA:1$smdp.example.com$ACTIVATION-CODE\",\n \"iccid\": \"8901234567890123456\",\n \"total_data\": 1073741824,\n \"data_left\": 524288000,\n \"data_used\": false,\n \"status\": \"RELEASED\",\n \"time_assigned\": \"2026-03-21T12:00:00.000Z\"\n },\n \"current_esim_packages\": [\n {\n \"template\": \"template-id\",\n \"destination_bundle\": \"bundle-id\",\n \"destination_iso3\": \"FRA\",\n \"assigned_at\": \"2026-03-21T12:00:00.000Z\",\n \"status\": \"ACTIVE\",\n \"total_bytes\": 1073741824\n }\n ],\n \"partner\": {\n \"id\": \"partner-id\",\n \"name\": \"Partner Name\"\n }\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"what-to-render-based-on-state"},"children":["What to render based on state"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"user.has_universal_esim"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user.has_universal_esim"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to show"},"children":["What to show"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No eSIM yet — waiting for a booking"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," (with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show eSIM installation flow (Step 3) or data meter depending on eSIM status"]}]}]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"current_esim.status"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim.status"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to show"},"children":["What to show"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RELEASED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eSIM profile ready — show installation flow (Step 3) using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qr"]}," field"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSTALLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eSIM on device — show package queues or data meter"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ENABLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eSIM active with data — show data meter with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data_left"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_data"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"package_queues"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_queues"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to show"},"children":["What to show"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entries with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redeemed_at: null"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Redeem\" button — use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," field to redeem (Step 5)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No unredeemed entries"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Get more data\" prompt (Step 7)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"when-to-call"},"children":["When to call"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Every time the traveler opens the eSIM section in your app"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After redeeming a package queue (to confirm the updated eSIM state)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After a top-up purchase (to confirm the new package queue appeared)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Periodically for data meter refresh (or rely on ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/advanced-topics/webhooks"},"children":["webhooks"]}," instead)"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3--esim-installation"},"children":["Step 3 — eSIM Installation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim"]}," is present and the eSIM status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RELEASED"]},", the traveler needs to install the eSIM. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qr"]}," field in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim"]}," contains the LPA string you need for installation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"installation-credentials"},"children":["Installation Credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim.qr"]}," field contains the full LPA string in the format ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LPA:1$$"]},". You can parse it or use it directly:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Source"},"children":["Source"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim.qr"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full LPA string — use for QR code generation or programmatic install"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim.iccid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ICCID of the eSIM profile"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"platform-specific-installation"},"children":["Platform-Specific Installation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["iOS 17.4+"]}," — Use the LPA string from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim.qr"]}," for programmatic installation via the Carrier Provisioning API. The traveler never leaves your app."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["iOS (older versions)"]}," — Generate a QR code from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim.qr"]}," LPA string. Instruct the traveler to scan it via Settings → Mobile Data → Add eSIM → Use QR Code."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Android"]}," — Parse the SM-DP+ address and activation code from the LPA string and use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTION_EMBEDDED_SUBSCRIPTION_PROVISIONING"]}," intent:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"kotlin","header":{"controls":{"copy":{}}},"source":"// current_esim.qr = \"LPA:1$smdp.example.com$ACTIVATION-CODE\"\nval parts = lpaString.removePrefix(\"LPA:1$\").split(\"$\")\nval intent = Intent(EuiccManager.ACTION_OTA_ESIM_PROVISIONING)\nintent.putExtra(\"server_address\", parts[0])\nintent.putExtra(\"matching_id\", parts[1])\nstartActivity(intent)\n","lang":"kotlin"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tip:"]}," Use the installation instructions endpoint (Step 4) instead of hard-coding instructions. It returns device-tailored steps and stays current as OS versions change."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4--get-installation-instructions"},"children":["Step 4 — Get Installation Instructions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/native/instructions"]}]}," — returns AI-generated, device-specific installation instructions tailored to the traveler's exact device model, OS version, and locale. The service automatically resolves the user's eSIM status, activation string, and partner visual identity from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]},", so the returned instructions are fully branded and context-aware."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You do not need to maintain installation content in your app — Hubby keeps it current for every device and OS version."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n 'https://api.hubbyesim.com/api/native/instructions' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1711200000000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"format\": \"html\",\n \"external_user_id\": \"user_abc123\",\n \"device_name\": \"Google Pixel 10\",\n \"device_type\": \"phone\",\n \"phone_os\": \"android\",\n \"os_version\": \"15\",\n \"locale\": \"mk-MK\"\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response shape is dynamic and depends on the requested ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["format"]},". The instructions adapt to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Device model and OS version"]}," — different steps for iOS 17.4+ (programmatic) vs older iOS (QR scan) vs Android (intent-based)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["eSIM state"]}," — if already installed, instructions shift to activation/troubleshooting"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Locale"]}," — instructions returned in the requested language"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partner branding"]}," — visual identity applied to the generated instructions"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5--check-device-compatibility"},"children":["Step 5 — Check Device Compatibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before starting the eSIM flow, you can check whether the traveler's device supports eSIM."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"check-a-specific-device"},"children":["Check a specific device"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/native/device-compatibility"]}]}," — pass the device details and get a compatibility result."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n 'https://api.hubbyesim.com/api/native/device-compatibility' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1711200000000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"phone_brand\": \"Google\",\n \"phone_model\": \"Pixel 10\"\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"success\": true,\n \"data\": {\n \"phone_brand\": \"Google\",\n \"phone_model\": \"Pixel 10\",\n \"is_compatible\": true\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"list-all-compatible-devices"},"children":["List all compatible devices"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/native/device-compatibility"]}]}," — returns all known devices and their eSIM compatibility. Use this to build a compatibility page or pre-filter device selection in your app."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n 'https://api.hubbyesim.com/api/native/device-compatibility' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1711200000000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"success\": true,\n \"data\": {\n \"devices\": [\n {\n \"phone_brand\": \"Apple\",\n \"phone_model\": \"iPhone 15 Pro\"\n },\n {\n \"phone_brand\": \"Samsung\",\n \"phone_model\": \"Galaxy S24\"\n }\n ]\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," The device list is being continuously expanded. The single-device check endpoint is the recommended approach for real-time compatibility verification."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-6--redeem-a-package-queue"},"children":["Step 6 — Redeem a Package Queue"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/native/redeem-package"]}]}," — redeems a pending package queue entry, provisioning the package onto the traveler's universal eSIM. Pass the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]}," and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_queue_id"]}," (the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," field from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_queues"]}," in the user dashboard response)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n 'https://api.hubbyesim.com/api/native/redeem-package' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1711200000000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"external_user_id\": \"user_abc123\",\n \"package_queue_id\": \"pq_xyz789\"\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"success\": true,\n \"message\": \"Package queue redeemed successfully\",\n \"data\": {\n \"package_queue\": {\n \"uuid\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"type\": \"booking\",\n \"redeemed_at\": null,\n \"package_specification\": {\n \"iso3\": \"FRA\",\n \"bytes\": 1073741824,\n \"duration_days\": 30\n }\n },\n \"current_esim\": {\n \"iccid\": \"8901234567890123456\",\n \"qr\": \"LPA:1$smdp.example.com$ACTIVATION-CODE\",\n \"name\": \"Hubby Universal ESIM\",\n \"status\": \"RELEASED\",\n \"data_left\": 1073741824,\n \"total_data\": 1073741824,\n \"last_updated\": \"2026-03-23T12:00:00.000Z\",\n \"time_assigned\": \"2026-03-23T12:00:00.000Z\",\n \"esim_type\": \"classic\",\n \"provider\": \"esim-provider\"\n },\n \"current_esim_packages\": [\n {\n \"allowance_seconds\": 2592000,\n \"allowance_hours\": 720,\n \"allowance_days\": 30,\n \"assigned_at\": \"2026-03-23T12:00:00.000Z\",\n \"date_activated\": null,\n \"status\": \"ACTIVE\",\n \"total_bytes\": 1073741824,\n \"type\": \"data\"\n }\n ]\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response returns the redeemed package queue entry along with the updated eSIM state and current packages, so you can immediately update the UI without an extra dashboard call."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-7--top-up"},"children":["Step 7 — Top-Up"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To add more data, create another booking with the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]},". The new package is automatically queued onto the traveler's existing eSIM — no re-installation needed."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n 'https://api.hubbyesim.com/api/bookings' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1717689600000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"departure_date\": \"2026-07-20\",\n \"package_specifications\": [\n {\n \"external_user_id\": \"partner_user_456\",\n \"destination\": \"GR\",\n \"size\": \"3GB\"\n }\n ]\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the same booking endpoint as Step 1. The Universal eSIM architecture means every new package for the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]}," is added to their existing eSIM — one installation, unlimited top-ups."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-8--monitor-usage"},"children":["Step 8 — Monitor Usage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Two approaches, use both:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pull: User dashboard endpoint"]}," — call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/native/user-dashboard?external_user_id=..."]}," to refresh the data meter. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim"]}," object includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data_left"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_data"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current_esim_packages"]}," lists each package with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_bytes"]}," and status."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Push: Webhooks"]}," — receive real-time events at 20%, 50%, and 80% data usage thresholds. Map these to push notifications. See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/advanced-topics/webhooks"},"children":["webhooks guide"]}," for the full event catalog."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Event"},"children":["Event"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Suggested action"},"children":["Suggested action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package.usage.50_percent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"You've used half your data in Greece\" (or \"Your package is halfway through\")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package.usage.80_percent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Running low — top up now to stay connected\" (or \"Your package expires in 6 days\")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booking.within_cutoff"]}," (eSIM not installed)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Your trip is in 7 days — install your eSIM now\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booking.about_to_depart"]}," (eSIM not installed)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Departing in 2 hours — install before you board\""]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-9--payments"},"children":["Step 9 — Payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the Native eSIM Integration model, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["you are the Merchant of Record"]},". Hubby never touches payments. You handle the payment flow in your app using your own PSP, then call the booking endpoint to provision the package."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Hubby provides B2B net rates and recommended B2C prices in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/openapi"},"children":["package catalog"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /destinations/{id}"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You set your own retail prices or use Hubby's B2C recommendations (continuously updated based on market rates)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Hubby invoices you monthly at B2B net rates"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"package-catalog"},"children":["Package Catalog"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Hubby API is organized around ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Destinations"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bundles"]}," — the same concepts your travel platform already uses. A Destination is a country or region; each Destination has one or more Bundles (data products with different sizes, durations, and prices). Use the destination endpoints to build your package selection UI:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/destinations"]}]}," — all available destinations (countries and regions) with localized names, ISO3 codes, and metadata."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n 'https://api.hubbyesim.com/api/destinations' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1717689600000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/destinations/{id}"]}]}," — a single destination with its available bundles (data packages) including B2B and B2C prices."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n 'https://api.hubbyesim.com/api/destinations/GR' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1717689600000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support-integration"},"children":["Support Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Native eSIM Integration partners, support is integrated via the Intercom SDK:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Embed the Intercom SDK in your iOS and Android app"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When opening a support session, populate user context fields:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["device_model"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["os"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["os_version"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booking_destination"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["departure_date"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_status"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["esim_status"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Hubby's support team (AI + human) receives this context automatically"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["First response time: < 3 minutes"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Escalation paths:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Direct:"]}," Traveler → Hubby AI → Hubby human agent"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Via partner:"]}," Traveler → your support team → escalation to Hubby via dedicated channel"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"platform-guarantees"},"children":["Platform Guarantees"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Metric"},"children":["Metric"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Commitment"},"children":["Commitment"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API uptime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["99.99% (Google Cloud SLA)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Provisioning success rate"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["99.9%"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Support first response (human)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["< 3 minutes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Webhook delivery"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Best-effort, near-real-time"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data usage reporting delay"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["~15 minutes (industry-wide telco limitation)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Backward compatibility"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4+ years without breaking changes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limiting"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None (elastic serverless infrastructure)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-advantages-over-other-esim-apis"},"children":["Key Advantages Over Other eSIM APIs"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"package-specs-not-package-ids"},"children":["Package Specs, Not Package IDs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You specify destination + size. Hubby auto-routes to the optimal package. No catalog sync, no stale IDs, no manual mapping."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"universal-esim"},"children":["Universal eSIM"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One eSIM per traveler, installed once. Every subsequent package queues onto the same eSIM. Multi-destination trips, top-ups, returning travelers — all on one installation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"zero-telco-exposure"},"children":["Zero Telco Exposure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your integration never sees ICCIDs, MCC/MNC codes, or carrier-specific provisioning flows. Hubby abstracts all telco complexity behind clean REST endpoints."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ai-powered-installation-instructions"},"children":["AI-Powered Installation Instructions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Device-specific, OS-aware, locale-aware installation steps generated on the fly. No hard-coded content to maintain in your app."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"hmac-authentication"},"children":["HMAC Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Simpler than OAuth2 — no token lifecycle, no refresh flows. One HMAC signature per request using your secret key. See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/authentication"},"children":["authentication guide"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"travel-aware-webhooks"},"children":["Travel-Aware Webhooks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Departure-time triggers (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booking.within_cutoff"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booking.about_to_depart"]},") that no generic eSIM API offers. Built for travel, not just connectivity."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-start-checklist"},"children":["Quick-Start Checklist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Your team provides:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]}," format (your internal user ID)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Package selection UI designs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Payment flow (your PSP)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Push notification mapping for webhook events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Installation UI (or use Hubby's instructions endpoint)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Technical point of contact"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hubby provides:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," API keys (staging + production)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Staging environment with all endpoints"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Package catalog with B2B + B2C prices"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," AI-powered installation instructions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Intercom SDK configuration for support"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Integration support throughout the process"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related"},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/openapi"},"children":["API Reference — Native eSIM Integration endpoints"]}," — OpenAPI spec for user state, instructions, and package activation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/webview"},"children":["Hubby WebView"]}," — alternative integration path with managed UI"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/authentication"},"children":["Authentication guide"]}," — HMAC-SHA256 setup"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/advanced-topics/webhooks"},"children":["Webhooks"]}," — full event catalog (shared with WebView)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/advanced-topics/multi-destination"},"children":["Multi-destination bookings"]}," — advanced booking patterns"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/advanced-topics/package-types"},"children":["Package types"]}," — starter, data-limited, unlimited, time-limited"]}]}]},"headings":[{"value":"Hubby Native eSIM Integration","id":"hubby-native-esim-integration","depth":1},{"value":"What You Build vs. What Hubby Handles","id":"what-you-build-vs.-what-hubby-handles","depth":2},{"value":"Architecture","id":"architecture","depth":2},{"value":"The Full Flow","id":"the-full-flow","depth":2},{"value":"Step 1 — Create a Booking","id":"step-1--create-a-booking","depth":3},{"value":"Step 2 — Fetch User Dashboard","id":"step-2--fetch-user-dashboard","depth":3},{"value":"What to render based on state","id":"what-to-render-based-on-state","depth":4},{"value":"When to call","id":"when-to-call","depth":4},{"value":"Step 3 — eSIM Installation","id":"step-3--esim-installation","depth":3},{"value":"Installation Credentials","id":"installation-credentials","depth":4},{"value":"Platform-Specific Installation","id":"platform-specific-installation","depth":4},{"value":"Step 4 — Get Installation Instructions","id":"step-4--get-installation-instructions","depth":3},{"value":"Step 5 — Check Device Compatibility","id":"step-5--check-device-compatibility","depth":3},{"value":"Check a specific device","id":"check-a-specific-device","depth":4},{"value":"List all compatible devices","id":"list-all-compatible-devices","depth":4},{"value":"Step 6 — Redeem a Package Queue","id":"step-6--redeem-a-package-queue","depth":3},{"value":"Step 7 — Top-Up","id":"step-7--top-up","depth":3},{"value":"Step 8 — Monitor Usage","id":"step-8--monitor-usage","depth":3},{"value":"Step 9 — Payments","id":"step-9--payments","depth":3},{"value":"Package Catalog","id":"package-catalog","depth":2},{"value":"Support Integration","id":"support-integration","depth":2},{"value":"Platform Guarantees","id":"platform-guarantees","depth":2},{"value":"Key Advantages Over Other eSIM APIs","id":"key-advantages-over-other-esim-apis","depth":2},{"value":"Package Specs, Not Package IDs","id":"package-specs-not-package-ids","depth":3},{"value":"Universal eSIM","id":"universal-esim","depth":3},{"value":"Zero Telco Exposure","id":"zero-telco-exposure","depth":3},{"value":"AI-Powered Installation Instructions","id":"ai-powered-installation-instructions","depth":3},{"value":"HMAC Authentication","id":"hmac-authentication","depth":3},{"value":"Travel-Aware Webhooks","id":"travel-aware-webhooks","depth":3},{"value":"Quick-Start Checklist","id":"quick-start-checklist","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Hubby Native eSIM Integration","description":"Build a fully custom eSIM experience in your native app — from booking to data meter, with full control over the UI","seo":{"title":"Hubby Native eSIM Integration"}},"lastModified":"2026-03-25T12:00:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/native-api","userData":{"isAuthenticated":false,"teams":["anonymous"]}}