Webhooks
Webhooks add payment and subscription lifecycle events as soon as a billing provider delivers them. They complement provider syncs, which help import historical data.
Endpoint format
After connecting a revenue provider, OnRamp shows the exact endpoint in Integrations → Revenue:
https://your-domain/api/integrations/webhooks/:provider?integration_id=:integrationId
Supported providers are Stripe, RevenueCat, Paddle, and Lemon Squeezy. Use the URL generated for that specific connection. Do not share an endpoint between projects.
Verification
Each provider signs requests differently. Copy the provider’s signing secret into OnRamp where requested. OnRamp verifies the signature before accepting an event.
| Provider | Verification |
|---|---|
| Stripe | Provider-generated endpoint signing secret |
| RevenueCat | Shared authorization secret |
| Paddle | Paddle-Signature signing secret |
| Lemon Squeezy | X-Signature signing secret |
Test safely
Use the provider’s test-delivery tool after setup. A successful HTTP response only confirms delivery and signature verification. Check the user and revenue views afterwards to confirm identity resolution is working too.