Quick Start Guide

This guide covers the four essential steps to launch a basic Zellify funnel. We'll use a sandbox environment so you can test everything safely before going live

Connect Your Custom Domain 🌐

Your custom domain is the branded URL for your funnel (e.g., subscribe.myapp.com). It's crucial for building trust with users and is a requirement for features like Apple Pay.

Important:

The domain or subdomain you use must be dedicated exclusively to Zellify. It cannot be used for your main website or any other service.

  1. Enter Your Domain: In the Zellify Control Panel, navigate to the domain settings. Enter the full subdomain you plan to use.

  2. Update DNS Records: We'll provide you with TXT and CNAME records. You need to log in to your DNS provider (like Cloudflare, GoDaddy, or Namecheap) and add these records to your domain's configuration.

  3. Verify: After adding the records, return to the Zellify dashboard and click the Verify button. Our system will check your DNS settings to confirm your ownership. This can sometimes take a few minutes to propagate.

Configure a Payment Provider (Sandbox Mode) 💳

Before you process real payments, you need to connect a payment provider. We'll start in Sandbox Mode, which lets you simulate the entire payment flow without using real money. For this guide, we'll use Stripe.

  1. Navigate to Payments: In the Zellify dashboard, go to Settings > Payments.

  2. Enable Sandbox Mode: Make sure the environment toggle is set to "Sandbox".

  3. Connect Stripe: Select Stripe as your payment provider and click Connect.

  4. Authorize Connection: You'll be redirected to Stripe. For a sandbox setup, you don't need to fill out the full form. Simply find and click the "Skip this form" button to complete the one-click sandbox connection.

You're now ready to create test subscriptions and simulate payments!

Set Up a Webhook Endpoint 🎣

Webhooks let Zellify notify your backend in real-time when billing events occur.

  1. Create an Endpoint: On your server, create an HTTPS URL that accepts POST with application/json, verifies signatures, and responds within ~3 seconds.

  2. Add Endpoint in Dashboard: Go to Settings → Developer. Paste your URL into Your App Webhook URL and click Save.

  3. Send a Test: Click Test next to the URL to send a sample event. Verify your server receives it.

  4. Secure It: Copy Your App Webhook Secret and verify requests by computing an HMAC-SHA256 over the raw request body and comparing to the X-Zellify-Signature header.

Essential events you'll receive:

  • subscription.created

  • subscription.updated

  • transaction.created

  • transaction.updated

Configure a Deferred Deeplink 🔗

Bridge your funnel to your native app using AppsFlyer OneLink.

  1. Create a OneLink: In AppsFlyer, create a OneLink and copy the base URL (e.g., https://yourapp.onelink.me/abc123).

  2. Add the Component: In your Zellify funnel editor, open the left Component Library → Integrations, add the AppsFlyer OneLink component to your post-purchase page.

  3. Configure: Paste your base OneLink into the OneLink URL. Optionally choose parameters to append (e.g., email, funnelId, timestamp, customer UID, organization) and customize their keys.

  4. Publish and Test: Publish the funnel, visit it on a real device, and verify your app handles the OneLink and reads parameters on first open.

Note:

  • Email interpolation requires the user to have authenticated earlier in the funnel; otherwise email will not be appended.

You're All Set!

Congratulations! You have now configured a complete, end-to-end subscription funnel. You can run test purchases to see it all in action.

When you're ready to explore more advanced features, check out our 📚 Guides section for deep dives on integrating providers and analytics tools.

PreviousIntroductionNextCustom Domains

Last updated