Winora
Back to docs

Integrations

Stripe integration

Connect Stripe to see customer billing plan, status, and renewal date inside Winora.

Stripe integration

The Stripe integration lets you see a customer's billing information - plan name, subscription status, and renewal date - directly inside Winora without switching tabs. This appears automatically in the inbox right panel and in the contact profile whenever a conversation or contact email matches a Stripe customer.

Prerequisites

  • A Stripe account with active customers
  • Owner or Admin role in your Winora workspace

Step 1 — Create a Restricted Key in Stripe

For security, use a Restricted Key with read-only permissions rather than your main Secret Key.

  1. Log in to the Stripe Dashboard.
  2. Go to Developers → API keys → Create restricted key.
  3. Give it a name (e.g. "Winora - read only").
  4. Under Permissions, enable Read access for:
    • Customers
    • Subscriptions
  5. Leave everything else as None.
  6. Click Create key and copy the key (starts with rk_live_ or rk_test_).

Step 2 — Connect Stripe in Winora

  1. Open your Winora workspace and go to Settings → Integrations.
  2. Find Stripe in the integrations list and click Connect.
  3. Paste your Restricted Key into the Secret key field.
  4. Click Save & Connect.

A green Connected badge will appear next to Stripe once saved.

How it works

After connecting, whenever a contact emails you:

  • Winora looks up their email address in your Stripe account.
  • If a matching customer is found, a 💳 Stripe card appears in:
    • The inbox right panel when viewing the conversation
    • The contact detail panel in the Contacts page
  • The card shows:
    • Plan name (e.g. "Pro Monthly")
    • Status (active, trialing, past_due, cancelled)
    • Renewal date (next billing date)

If no Stripe customer is found for that email, the card does not appear.

Disconnecting

Go to Settings → Integrations → Stripe and click Disconnect. Winora stops making Stripe API calls immediately. Your Stripe data is not deleted from Winora - it simply stops being fetched.

Using test mode

If you want to test the integration with Stripe test data, use a Restricted Test Key (starts with rk_test_). Create test customers in the Stripe dashboard and send test messages from matching email addresses.