Wix guide

Create a Wix app and configure it so that you can process payments and storefront data through Rutter.

Wix moved custom app management into Wix Studio (manage.wix.com/studio/custom-apps). The older dev.wix.com/dc3/my-apps Dev Center is deprecated. The steps below reflect the current Wix Studio UI. You need a Wix Studio account (sign up at wix.com/studio) — a "Wix developer account" is no longer a separate thing.

This guide applies to older Wix apps only — an updated guide is in progress. Wix deprecated Custom authentication (the App URL + Redirect URL install handshake this guide relies on). Per Wix's docs, custom authentication is no longer available for newly created apps — and new apps are now the only kind Wix lets you create. New apps use OAuth (client credentials) instead, and the App URL / Redirect URL fields no longer appear on the OAuth page.

  • Creating a new Wix app today? The steps below do not apply to you. We are actively writing an updated guide for the new OAuth flow. In the meantime, contact your Rutter onboarding team before proceeding and we'll walk you through it.
  • Configuring an existing app that still shows the Custom authentication (legacy) section on its OAuth page? The steps below still apply — continue.

Create a Wix app

  1. Go to Custom Apps in Wix Studio.
  2. Click Create New App → Build from scratch. (The dropdown also offers "Build with AI" and "Start with a template" — Rutter integrations start from scratch.)
    • In the Choose a framework to start building dialog, select Self-Managed ("Take full control over your tech stack, deployment, and hosting") and click Get Started. (Do not pick Wix CLI or Wix Blocks.) Give the app a name.
  3. You'll land on the app's Home at manage.wix.com/apps/{APP_ID}/home. The left nav has five groups: Home, Develop, App Profile, Distribute, Manage. All the configuration below lives under Develop.

Configure OAuth (redirect + app URLs) — existing apps only

  1. Go to Develop → OAuth. Find your Rutter organization ID here.
    • Expand the Custom authentication (legacy) section. If this section isn't present, your app is a new app that uses OAuth client credentials — skip this step and contact your Rutter onboarding team (see the note at the top).
    • Set the App URL to https://production.rutterapi.com/wix/proxy/${YOUR_RUTTER_ORG_ID}/app-url
    • Set the Redirect URL to https://production.rutterapi.com/wix/proxy/${YOUR_RUTTER_ORG_ID}/redirect-url

Add permissions

  1. Go to Develop → Permissions → Add Permissions.
    • Add Wix Stores → Manage Stores - all permissions.
    • Wix is migrating Wix Stores to the Catalog V3 APIs. To make sure every merchant (old and new sites) can install your app, go to Develop → App Settings → Wix Stores Catalog V1 & V3 compatibility and click Confirm Compatibility once your app supports both. If you skip this, some sites won't be able to install the app.

Add webhooks

  1. Go to Develop → Webhooks → Create Webhook. Webhooks are now added one event at a time: filter by category (or search), click Select Event, then paste the callback URL and click Subscribe. Repeat for each event below.

    The callback URL for every Rutter webhook is: https://production.rutterapi.com/wix/proxy/${YOUR_RUTTER_ORG_ID}/webhooks

    Subscribe to these events:

    • eCommerce → Product Deleted
    • eCommerce → Order Created, Order Updated, and Order Canceled
    • App Instance → App Removed

    The old Wix Stores → Order created event is now marked DEPRECATED in the Wix UI. Use the eCommerce order events instead. If you are unsure which events your Rutter environment expects, confirm with your Rutter onboarding contact — Rutter's proxy only acts on ProductDeleted, the eCommerce Orders event, and AppRemoved.

  2. Get the webhook signing public key: on Develop → Webhooks, on the Subscriptions tab, click Get Public Key (top right). Click Copy Key and share the JWT-encoded public key with your Rutter onboarding team member. (This replaces the old "Public key → Open" step, which used to live on the OAuth page.)

Add the dashboard component

  1. Go to Develop → Extensions → Create Extension → Dashboard Page. (This replaces the old "Components → Dashboard Component".)
  2. For the Dashboard Page URL, enter the login page merchants use to log into your service.

Copy your keys into Rutter

  1. Go to Develop → OAuth → App keys. Copy the App ID and reveal + copy the App Secret Key.
  2. Go to https://dashboard.rutterapi.com/platforms/wix and paste your App ID and App Secret Key into the Rutter config.
  3. Go to https://dashboard.rutterapi.com/customize, expand Platforms, and enable Wix.
  4. Make sure you have set up the Direct App Install Redirect URL on https://dashboard.rutterapi.com/platforms. This is the redirect URL for all platforms that have an App Marketplace (Wix, Shopify, BigCommerce, etc.).

Test the install flow

  1. Click Test App (top right on any Develop page) to preview the authorization flow, or use Distribute → Share Install Link / Install on Site to install the app on a Wix site you control and verify the connection works end to end.

Create a Wix Test Store

  1. Go to wix.com and create a new site.
  2. Choose an Online Store business type so the site has the Wix Stores app.
  3. Pick any template/theme and publish the site.
  4. (Optional) To place real test orders you need a paid Business & eCommerce plan: https://manage.wix.com/wix/api/premiumStart.

Wix changes the site-creation onboarding flow frequently (ADI, templates, AI builder, etc.). The exact clicks vary — the only requirement for Rutter is that the finished site has the Wix Stores app installed.

Launch Your Wix App on the Wix App Market

You do not need App Market approval to use the app with a specific merchant: use Distribute → Share Install Link or Install on Site for private distribution. Public listing on the App Market requires review (Wix usually takes ~2 weeks; Israeli holidays can add delay). To submit:

  1. From the app, complete every section under App Profile: App Info, Media, App Audience, Get Found, Pricing, Contact Info, and Company Info.
  2. Go to Distribute → Submit to App Market. If there are blockers, click Show Blockers and resolve each one, then submit.
  3. During submission you'll provide testing instructions and a test account for the Wix reviewer.
    • We recommend creating a test account on your own service and only allowing that account to authorize a Wix store, so Wix reviewers can test the flow end to end without exposing the connection feature to your customers before approval. Until Wix approves the app, no other Wix merchant can connect to it (unless you share a private install link).
  4. Wait for the email from Wix App Review for the next step.
Previous
Webflow
Next
WooCommerce