Skip to main content

​
What is a webhook?

Creem uses webhooks to push real-time notifications to you about your payments and subscriptions. All webhooks use HTTPS and deliver a JSON payload that can be used by your application. You can use webhook feeds to do things like:
  • Automatically enable access to a user after a successful payment
  • Automatically remove access to a user after a canceled subscription
  • Confirm that a payment has been received by the same customer that initiated it.
In case webhooks are not successfully received by your endpoint, creem automatically retries to send the request with a progressive backoff period of 30 seconds, 1 minute, 5 minutes and 1 hour.

​
Steps to receive a webhook

You can start receiving real-time events in your app using the steps:
  • Create a local endpoint to receive requests
  • Register your development webhook endpoint on the Developers tab of the Creem dashboard
  • Test that your webhook endpoint is working properly using the test environment
  • Deploy your webhook endpoint to production
  • Register your production webhook endpoint on Creem live dashboard
On Next.js projects, the @creem_io/nextjs adaptor exports a Webhook helper that verifies signatures and surfaces typed lifecycle callbacks. Use it as your default implementation before falling back to manual parsing.

​
1. Create a local endpoint to receive requests

In your local application, create a new route that can accept POST requests. 
// app/api/webhook/creem/route.ts
import { Webhook } from "@creem_io/nextjs";

export const POST = Webhook({
  webhookSecret: process.env.CREEM_WEBHOOK_SECRET!,
  onCheckoutCompleted: async ({ customer, product }) => {
    console.log(`${customer.email} purchased ${product.name}`);
  },
  onGrantAccess: async ({ customer, metadata }) => {
    const userId = metadata?.referenceId as string;
    await grantAccess(userId, customer.email);
  },
  onRevokeAccess: async ({ customer, metadata }) => {
    const userId = metadata?.referenceId as string;
    await revokeAccess(userId, customer.email);
  },
});
On receiving an event, you should respond with an HTTP 200 OK to signal to Creem that the event was successfully delivered.

​
2. Register your development webhook endpoint

Register your publicly accessible HTTPS URL in the Creem dashboard.
You can create a tunnel to your localhost server using a tool like ngrok. For example: https://8733-191-204-177-89.sa.ngrok.io/api/webhooks

​
3. Test that your webhook endpoint is working properly

Create a few test payments to check that your webhook endpoint is receiving the events.

​
4. Deploy your webhook endpoint

After you’re done testing, deploy your webhook endpoint to production.

​
5. Register your production webhook endpoint

Once your webhook endpoint is deployed to production, you can register it in the Creem dashboard.