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

Test Your First Link

Verify one Smart Link across web, installed-app, non-installed, store-fallback, and social-preview scenarios before production use.

Purpose

Use this test plan before sharing a Smart Link publicly. It verifies routing behavior across platforms and installation states.

Prerequisites

  • An activated Smart Link.
  • Access to at least one iOS or Android test device when mobile routing is configured.
  • A production-like app build with the required platform association.
  • The expected web, in-app, and store destinations written down before testing.

Test Matrix

ScenarioExpected destination
Desktop browserConfigured web destination or fallback
Mobile with app installedMapped route inside the app
Mobile without app installedCorrect App Store, Google Play, or web fallback
Unsupported platformSafe web fallback
Shared in messaging or social mediaConfigured title, description, and image

Step 1 — Verify the Web Destination

  1. Open a private browser window.
  2. Paste the Smart Link directly into the address bar.
  3. Confirm that the final destination, path, and approved query parameters are correct.
  4. Repeat in a desktop and mobile browser when both experiences are supported.

Step 2 — Test With the App Installed

  1. Install a production-like build on the device.
  2. Open the Smart Link from a real clickable surface such as a message, email, or web page.
  3. Confirm that the operating system opens the app without an unnecessary chooser or browser detour.
  4. Confirm that the expected in-app route and content appear.

Step 3 — Test Without the App

  1. Remove the app from the test device or use a clean device.
  2. Open the same Smart Link.
  3. Confirm that the correct store or web fallback opens.
  4. If deferred routing is configured, install and launch the app, then verify the documented post-install destination.

Step 4 — Verify the Social Preview

  1. Paste the Smart Link into a private draft or preview surface.
  2. Confirm the title, description, and image.
  3. Do not send the test message publicly until the preview is correct.

Pass Criteria

The test passes only when every configured platform and installation state reaches its expected destination without exposing private data or creating a routing loop.

Troubleshooting

  • The browser opens instead of the app: verify the platform association, signing identity, domain, and path match.
  • The wrong store opens: verify the iOS and Android fallback URLs separately.
  • The app opens the wrong screen: verify the route mapping and parameter parsing inside the app.
  • A redirect loops: remove circular fallback rules and retest in a private session.
  • The share preview is stale: update the metadata and allow the sharing platform to refresh its cache.

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