ZipQuantum Documentation

Everything you need to use Smart Links, Deferred Deep Linking, and QR Smart Codes — safely.

No proprietary SDK · No fingerprinting · Privacy-first

Create your first Smart Link in minutes

API integration, parameters, and error handling

Endpoints, parameters, and platform behavior.

Docs

Create Your First Smart Link

Create and activate a ZipQuantum Smart Link in three steps: paste a destination, configure routing, then preview and activate.

Purpose

This guide creates a shareable Smart Link from an existing web or in-app destination. The same link can include app-store fallbacks and a social preview.

Prerequisites

  • A destination URL that begins with https://.
  • Optional: the App Store and Google Play URLs for your app.
  • Optional: a title, description, and image URL for the social share card.

Step 1 — Paste Link

  1. Open the ZipQuantum creation form.
  2. In Your link, paste the destination URL. The corresponding field is original_url.
  3. Choose the Smart Subdomain that will appear before .zq.tn. The corresponding field is subdomain.
  4. Select Continue.

Step 2 — Link Settings

Configure only the options required by your use case:

  • iOS App Store URL (ios_app_store_url): used as the iOS fallback when the app is not installed.
  • Android Play Store URL (android_play_store_url): used as the Android fallback when the app is not installed.
  • Meta Title (meta_title): headline displayed when the link is shared.
  • Meta Description (meta_description): short supporting text for the share card.
  • Image URL (meta_image): optional preview image.

The store and social-preview fields are optional and can be updated later from the dashboard.

Step 3 — Preview & Activate

  1. Review the generated Smart Link and its preview.
  2. Confirm the destination, subdomain, store fallbacks, and social metadata.
  3. Select Activate My Smart Link.
  4. When Setup complete appears, copy the live link or select Go to Dashboard.

Expected Result

The Smart Link is live and ready to share. Activating it does not install code in your application.

Verification

  1. Open the link in a private browser window and confirm the web destination.
  2. Test on iOS and Android if store fallbacks were configured.
  3. Paste the link into a private message or preview tool and confirm the social title, description, and image.

Troubleshooting

  • Continue is unavailable: verify that the destination is a complete HTTPS URL.
  • The subdomain is rejected: choose another available value using letters, numbers, or hyphens.
  • The wrong store opens: verify the two store URLs and test again on the corresponding platform.
  • The share preview is outdated: update the metadata, then allow the destination platform to refresh its cached preview.

Get Started

Create your first ZipQuantum Smart Link in minutes — no proprietary SDK, no fingerprinting, and no attribution stack.

ZipQuantum links are install-aware by design.
They work before install, during install, and after install — using standard platform mechanisms only.

What You’ll Do Here

In this section, you’ll learn how to:

  • Create a Smart Link from the dashboard

  • Configure install-safe routing

  • Verify correct behavior across install states

  • Deploy links to production safely

No SDK integration is required.
No runtime interception.
No background services.

Prerequisites

Before you begin, make sure you have:

  • A ZipQuantum account

  • Access to your app’s App Store / Play Store listing

  • A destination URL or in-app route you want users to reach

That’s it.

Next Step

Create Your First Smart Link

This guide walks you through:

  • Creating a link

  • Testing install vs non-install behavior

  • Sharing it safely across channels