Getting Started with MRRX

From signup to your first saved subscriber — everything you need to set up MRRX and start retaining customers.

Create Your MRRX Account

Head to mrrx.app/sign-up and create your account. You can sign up with email or continue with Google or GitHub.

Connect Your Stripe Account

MRRX needs access to your Stripe account to execute retention actions on your subscriptions. The connection uses Stripe Connect OAuth — secure, revocable, and limited to subscription management.

Generate Your API Key

Your API key authenticates your application when creating cancellation sessions.

MRRX_API_KEY=mrrx_live_xxxxxxxxxxxxxxxxxxxxxxxxxx

Configure Retention Offers

Go to Settings → Offers to configure which retention offers your subscribers see when they try to cancel. You can enable any combination of four offer types:

Customize Your Branding

Go to Settings → Branding to make the cancellation flow look like your product, not a third-party tool.

Integrate the API

This is the core integration — one API call that connects your cancel button to MRRX. When a subscriber clicks "Cancel" in your app, create a session and redirect them.

// When subscriber clicks "Cancel Subscription"
async function handleCancelClick(customerId: string, subscriptionId: string) {
  const response = await fetch('https://mrrx.app/api/v1/sessions', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.MRRX_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      customer_id: customerId,
      subscription_id: subscriptionId,
    }),
  });

  const { url } = await response.json();

  // Redirect subscriber to MRRX retention flow
  window.location.href = url;
}

That's the entire integration. MRRX returns a hosted URL where the subscriber sees your branded retention offers. When they make a choice:

Set Up Webhooks

Webhooks notify your application in real time when events occur — a subscriber is saved, canceled, paused, or discounted. Go to Settings → Webhooks.

// Verify webhook signature
import crypto from 'crypto';

function verifyWebhook(payload: string, signature: string, secret: string) {
  const [timestamp, hash] = signature.split(',');
  const t = timestamp.replace('t=', '');
  const v1 = hash.replace('v1=', '');

  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${t}.${payload}`)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(v1), Buffer.from(expected)
  );
}

Available webhook events:

Connect Slack Notifications

Get real-time Slack alerts when subscribers are saved or cancel. Go to Settings → Slack.

You'll receive alerts for:

Use Analytics and Feedback

Your MRRX dashboard tracks everything automatically. No setup required — data flows in as soon as sessions start running.

Dashboard Overview

The main dashboard shows your key retention metrics at a glance:

Analytics Page

The Analytics page gives deeper insights:

Cancellation Reasons

The Reasons page aggregates exit survey responses so you can see why subscribers are leaving:

Session Detail

Click any session in the Sessions page to see the full timeline:

What's Next

You're set up. Here's what to do from here: