How RocketHooks Works with Stripe

While Stripe offers its own webhook system, RocketHooks adds a complementary monitoring layer that polls Stripe API endpoints for changes you define. This is useful for aggregated views, custom change detection logic, or scenarios where Stripe webhooks alone are not sufficient, such as monitoring specific field-level changes or combining Stripe data with other API sources.

Works with any Stripe account that has API access.

Authentication Setup

Stripe uses API key authentication. Use your restricted API key for security:

{
  "auth": {
    "type": "bearer",
    "token": "rk_live_YOUR_RESTRICTED_API_KEY"
  }
}

Create a restricted key in the Stripe Dashboard with only the read permissions your monitor needs.

Endpoint Examples

Monitor Recent Payments

Track successful payments in real time:

{
  "url": "https://api.stripe.com/v1/payment_intents?limit=20&created[gte]=UNIX_TIMESTAMP",
  "method": "GET",
  "pollInterval": 30,
  "changeDetection": {
    "strategy": "jsonpath",
    "expression": "$.data[*].id"
  }
}

Monitor Subscription Status Changes

Detect when subscriptions change status (active, past_due, canceled):

{
  "url": "https://api.stripe.com/v1/subscriptions?limit=50&status=all",
  "method": "GET",
  "pollInterval": 120,
  "changeDetection": {
    "strategy": "jsonpath",
    "expression": "$.data[*].status"
  }
}

Monitor Failed Invoices

Watch for invoice payment failures:

{
  "url": "https://api.stripe.com/v1/invoices?limit=20&status=open",
  "method": "GET",
  "pollInterval": 300,
  "changeDetection": {
    "strategy": "jsonpath",
    "expression": "$.data[*].id"
  }
}

Common Patterns

Revenue Dashboard

Poll Stripe for recent payments and push change events to your analytics pipeline. Build real-time revenue dashboards without relying solely on webhook delivery.

Churn Prevention

Monitor subscription status changes. When a subscription moves to past_due or unpaid, trigger automated retention workflows via webhooks to your backend systems.

Invoice Reconciliation

Track invoice status transitions and sync them with your accounting system. RocketHooks detects when invoices move between draft, open, paid, and void states.

Delivery Channels

Webhooks: Trigger billing workflows or sync with accounting via HMAC-signed payloads and automatic retries

Additional delivery channels (Slack, email, SMS) coming soon.

Next Steps

Create a restricted API key in the Stripe Dashboard
Grant only the read permissions your monitors need
Configure your first payment or subscription monitor
Set up webhook delivery for your finance workflow

Stripe Integration