Skip to content
Convertly Docs

Stripe Integration

Role of Stripe

Stripe handles subscription payments for Convertly CRM accounts using international currencies (USD, EUR, GBP, and others).

This integration is managed at the platform level — individual tenant organizations do not configure Stripe credentials. Stripe is active automatically for all accounts billed in non-INR currencies.

Payment webhook behavior

When a payment is completed via Stripe, Convertly receives a webhook from Stripe and automatically:

  1. Verifies the webhook signature (using Stripe’s signing secret)
  2. Identifies the tenant from the Stripe customer ID
  3. Updates the tenant’s plan status to Active
  4. Applies the correct plan limits (user seats, lead capacity)
  5. Records the payment in the billing history
  6. Sends a receipt email to the Admin

Payment status tracking

Payment statuses in Convertly map from Stripe events:

Stripe eventConvertly plan status
payment_intent.succeededActive
invoice.payment_failedWarning → Cancelled after retries
customer.subscription.deletedCancelled
customer.subscription.updatedPlan updated

Failed payment handling

When Stripe reports a failed payment:

  1. An email notification is sent to the Admin
  2. Stripe automatically retries the payment (Smart Retries — typically 3 attempts over 3–7 days)
  3. If all retries fail, Convertly receives the customer.subscription.deleted event and the plan status becomes Cancelled
  4. Team access to the CRM is suspended
  5. The Admin can re-enter card details at any time to reactivate

Tenant-side Stripe notes

From the tenant perspective:

  • Your Stripe customer ID is stored with your organization record
  • Stripe payments appear on your bank statement as “Convertly CRM” or the platform billing entity
  • For questions about a specific charge, include your Stripe payment reference when contacting support