Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.revtain.com/llms.txt

Use this file to discover all available pages before exploring further.

For Chargebee, Recurly, Stripe Billing, and Braintree Subscriptions, Revtain provides direct connectors that require no code on your side. Paste a single webhook URL into your billing platform settings — Revtain handles everything.

​
How Connectors Work

1

Select your billing platform during onboarding

Provide your platform API key (Chargebee API key, Recurly API key, etc.).
2

Get your unique webhook URL

Revtain generates a webhook URL with your client ID embedded.
3

Paste it into your billing platform's webhook settings

Select the relevant payment failure event (e.g., payment_failed).
4

Done — Revtain handles the rest

On every failed payment: extract the gateway token, run the recovery engine, mark the invoice paid on success.
No webhook handler to write. No API calls to make. No code to deploy.

​
Supported Connectors

PlatformWebhook URL PatternEvent Handled
Chargebeehttps://api.revtain.com/api/connectors/chargebee/webhook/{clientId}payment_failed
Recurlyhttps://api.revtain.com/api/connectors/recurly/webhook/{clientId}failed_payment
Stripe Billinghttps://api.revtain.com/api/connectors/stripe-billing/webhook/{clientId}invoice.payment_failed
Braintree Subscriptionshttps://api.revtain.com/api/connectors/braintree/webhook/{clientId}subscription_went_past_due

​
Setup Instructions

  1. During Revtain onboarding, select Chargebee as your billing platform
  2. Enter your Chargebee API key and site name (the xxx in xxx.chargebee.com)
  3. In Chargebee, go to Settings → Configure Chargebee → Webhooks
  4. Add a new webhook with the URL shown in your credentials modal (includes your client ID)
  5. Select the payment_failed event
What Revtain does automatically:
  • Looks up the customer’s Stripe payment token from Chargebee’s payment sources
  • Runs the recovery engine with the decline code from the failed transaction
  • On success, records the payment on the Chargebee invoice
  1. During Revtain onboarding, select Recurly as your billing platform
  2. Enter your Recurly API key and subdomain
  3. In Recurly, go to Integrations → Webhooks
  4. Add a new webhook endpoint using the URL from your credentials modal
  5. Select the failed_payment event
What Revtain does automatically:
  • Retrieves the gateway token from the customer’s billing info via Recurly’s API
  • Runs the recovery engine
  • On success, records an external payment on the Recurly account
  1. During Revtain onboarding, select Stripe Billing as your billing platform
  2. Your Stripe secret key is already provided as your gateway key — no additional key needed
  3. In Stripe, go to Developers → Webhooks
  4. Add a new endpoint using the URL from your credentials modal
  5. Select the invoice.payment_failed event
What Revtain does automatically:
  • Looks up the customer’s default payment method via the Stripe API
  • Runs the recovery engine with the invoice decline code
  • On success, pays the Stripe invoice via the Stripe API
  1. During Revtain onboarding, select Braintree as your billing platform
  2. Your Braintree credentials are already provided as your gateway key — no additional key needed
  3. In Braintree, go to Settings → Webhooks
  4. Add a new webhook destination using the URL from your credentials modal
  5. Select the Subscription Went Past Due notification
What Revtain does automatically:
  • Extracts the payment method token directly from the subscription data
  • Runs the recovery engine with the processor response code
  • On success, Braintree detects the payment and updates the subscription status

​
Connector vs. API Integration

Connector (Recommended)API Integration
Code requiredNone — paste one URLWebhook handler + API calls
Setup time5 minutes30-60 minutes
Invoice reconciliationAutomaticManual (in your webhook handler)
Available forChargebee, Recurly, Stripe Billing, BraintreeAny billing system
CustomisationStandard recovery flowFull control
Using a different billing platform? Use the API integration — Revtain works with any system that can make HTTP calls.