Platform Documentation

Revora Integration Hub

Revora is an automated customer retention platform built natively for Stripe. It intercepts subscribers at the cancellation button, presents verified concession alternatives, and automates billing adjustments.

What is Revora?

Revora bridges the gap between customer offboarding intent and subscription billing. By intercepting cancellation clicks in an isolated client Shadow DOM, Revora diagnoses customer churn drivers and executes server-side discount coupons or billing pauses directly against your existing Stripe account via Stripe Connect OAuth.

Zero Primary Disruption

Revora never touches checkout carts, card details, or merchant balances. It communicates strictly with Stripe Billing APIs.

100% Statutory Compliance

Guarantees strict adherence to FTC Click-to-Cancel Negative Option rules and California ARL § 17602 with automatic termination receipts.

System Architecture & Data Flow

Revora operates across three decoupled layers to guarantee sub-50ms execution speed, zero CSS contamination, and high security:

Revora Execution Topology

[1. Client Layer] Browser: Click [Cancel] -> revora-widget.js mounts in Shadow DOM

[2. Session API] POST /api/v1/sessions -> Verifies public key, customer ID & returns active flows

[3. Concession] POST /api/v1/sessions/:token/accept-offer -> Decrypts Stripe key & applies coupon/pause

[4. Persistence] PostgreSQL Ledger: Logs event in revora_session_events & updates MRR

[5. Legal Notice] Dispatch: Issues statutory Notice of Modification or Notice of Termination email

Quickstart Preview

Installing Revora on any web framework requires only two steps:

1. Include the Revora script tag:

index.html

<script
  src="https://revorahq.vercel.app/revora-widget.js"
  data-revora-key="pk_live_revora_YOUR_KEY_HERE"
  defer
></script>

2. Tag your existing Cancel Subscription button:

BillingSettings.html

<button
  data-revora-cancel
  data-customer-id="{{customer.id}}"
  data-subscription-id="{{subscription.id}}"
>
  Cancel Subscription
</button>

Read complete 2-minute quickstart guide

Integration Modules

Stripe Connect & Billing

OAuth token encryption (AES-256-GCM), automatic coupon injection, pause_collection hiatus, and idempotency guarantees.

Widget SDK & Styling

Shadow DOM isolation, HTML data attributes, JavaScript API, custom CSS injection for Pro, and competitor comparison matrices.

Sessions & Recovery Matrix

Session state machine transitions, event auditing, error classification (failed vs unknown), and data export (CSV, TXT, MD).

Regulatory Compliance

Statutory guidance for FTC Click-to-Cancel rules, California ARL § 17602, and automatic confirmation receipt delivery.

Statutory Compliance Architecture

Revora is designed specifically to ensure SaaS companies comply with legal subscription cancellation regulations. Subscribers can cancel with zero traps, and receive verified termination notices delivered automatically to their registered billing email address.