WonderSign In & Payment Integration
Wonder App Library — Reference Integration

Add Sign in & Pay with Wonder in minutes.

Two integration tracks — Sign In and Payment — each with multiple flows. The same patterns power GiftExpress, The Taxi Hub, JEK and every app in the Wonder App Library.

Sign In
Payment
App-to-App Deep Link

Hand off to the Wonder app and get the user back signed in.

Best for native mobile experiences. Build a signed deep link on your server, open it, and Wonder returns to your app via a callback URL with an authorization code.

  1. 1
    Your app requests a signed authorization URL from your server.
  2. 2
    User taps “Sign in with Wonder” — system opens the Wonder app.
  3. 3
    User approves; Wonder redirects to your callback URL with a code.
  4. 4
    Server exchanges the code for the user’s profile and access token.
ts
// server: build the signed deep link
const requestTime = Date.now();
const nonce = crypto.randomUUID();
const signature = await hmacSha256Hex(
  WONDER_APP_SECRET,
  `${CLIENT_ID}|${requestTime}|${nonce}`,
);

const url =
  `wonder://authorization` +
  `?client_id=${CLIENT_ID}` +
  `&request_time=${requestTime}` +
  `&nonce=${nonce}` +
  `&signature=${signature}` +
  `&callback=${encodeURIComponent(MY_CALLBACK_URL)}`;
Your app
🚕
Acme Taxi Management
Welcome back, driver
Sign in to dispatch rides, manage your fleet, and track earnings.
Tap to start the demo flow
Wonder app
Authorize
🚕
Acme Taxi Management
wants to sign you in
Your name and email
Your Wonder user ID
One-time access token