Documentation

Sign up and connect Stripe

Create your MRRX account and securely connect your Stripe account via OAuth.

Get your API key

Generate an API key from your dashboard under Settings → API Keys.

Create a cancellation session

When a user clicks 'Cancel Subscription' in your app, create a session and redirect them.

// Your cancel subscription handler
async function handleCancel(customerId, subscriptionId) {
  const response = await fetch('https://api.mrrx.app/v1/sessions', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      customer_id: customerId,
      subscription_id: subscriptionId,
      return_url: 'https://yourapp.com/account',
    }),
  });

  const { url } = await response.json();
  
  // Redirect user to MRRX cancellation flow
  window.location.href = url;
}

Handle the return

After the user completes the flow, they're redirected to your return_url with the outcome.

// Your return URL handler
async function handleReturn(sessionId) {
  const response = await fetch(
    `https://api.mrrx.app/v1/sessions/${sessionId}`,
    {
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
    }
  );

  const session = await response.json();
  
  // session.outcome?.action: 'pause' | 'discount' | 'cancel'
  if (session.outcome?.action === 'cancel') {
    // Subscription was canceled
  } else {
    // Subscription was saved!
  }
}