Introducing the Inngest TypeScript / JavaScript SDK

Update your Prisma database from Stripe events

Create a record in Prisma when a Stripe webhook is received.

npx inngest-cli init --template github.com/inngest/inngest#examples/prisma-typescript-function
See more quickstarts
Explore the code

Run a background job using the Prisma ORM and TypeScript to create a new entry in the database when a webhook is received from Stripe.

➡️ Check out the related guide: Running Prisma background jobs

graph LR Stripe -->|stripe/charge.succeeded| Inngest(Inngest) Inngest -->|Triggers| step1[steps/step-1] classDef in fill:#4636f5,color:white,stroke:#4636f5; classDef inngest fill:white,color:black,stroke:#4636f5,stroke-width:3px; classDef out fill:white,color:black,stroke:#4636f5,stroke-dasharray: 5 5,stroke-width:3px; class Stripe in; class Inngest,step1 inngest;
  1. Stripe sends stripe/charge.succeeded webhook
  2. If the relevant user is not found in the database:
    • ⚠️ Return 404 and doesn't retry, allowing you to handle the edge case
  3. If the relevant user is found in the database:
    • ✅ Create a new charge record

Contents

Usage

Use this quickstart with a single CLI command to get started! The CLI will then guide you through running, testing, and deploying to Inngest Cloud.

npx inngest-cli init --template github.com/inngest/inngest#examples/prisma-typescript-function

Next, check out how to 👉 trigger the function.

Configuration

Below is the annotated function definition (found at inngest.json) to show how the above is defined in config.

{
  "name": "Prisma background job",
  "description": "Create a record in Prisma when a Stripe webhook is received.",
  "tags": ["typescript", "prisma", "stripe"],
  "id": "cute-troll-547a93",
  "triggers": [
    {
      /**
       * When this event is recieved by Inngest, it will start the function
       */
      "event": "stripe/charge.succeeded",
      "definition": {
        "format": "cue",
        "synced": true,

        /**
         * The file that declares the event schema that your app will send to
         * Inngest.
         */
        "def": "file://./events/stripe-charge-succeeded.cue"
      }
    }
  ],
  "steps": {
    "step-1": {
      /**
       * This step defines to "after" block, so will be run as soon as the
       * trigger above is received.
       */
      "id": "step-1",
      /**
       * This is the directory where your code will be, including its Dockerfile
       */
      "path": "file://./steps/step-1",
      "name": "Prisma background job",
      "runtime": {
        "type": "docker"
      }
    }
  }
}

Code

This function has a single step: steps/step-1, which is triggered by the stripe/charge.succeeded event.

  • ➡️ steps/step-1/

    Finds the relevant user in the database and creates a new charge record if it could be found.

Triggering the function

To receive Stripe events in your Inngest account, you can connect Stripe via OAuth. To do this, create a new Source. This will link your Stripe and Inngest accounts so that we can automatically receive events as they happen.

Alternatively, you can send your own events from your own apps or any webhook and run any function automatically.

More quickstarts

See all quickstarts