Stripe Integration

Caution

You MUST have a WorkOS Integration with your Raindrop application before you can proceed with a Stripe Integration. To setup WorkOS with your Raindrop application, follow the WorkOS Integration tutorial.

This tutorial will guide you through the process of integrating Stripe with your Raindrop application.

Prerequisites

Before you begin:

• LiquidMetal Account: Sign up at liquidmetal.run
• A Raindrop Application with WorkOS Integration: WorkOS Integration Tutorial
• Raindrop CLI: Install the latest version of the Raindrop CLI:

npm i -g @liquidmetal-ai/raindrop@latest

Configure the Manifest with Stripe Payments

Add Stripe payments to your Raindrop application, by adding the following to your Raindrop application’s manifest:

raindrop.manifest

payments {
  mode = "live" // "test" or "live" is available with Stripe Payments, with test being the default mode
}

service "api" {
  visibility = "paid" // visibility "paid" is a protected visibility
  route "api" {
    cname = "api-prod"
  }
}

Deploy Your Application

Deploy your application by running the following command:

raindrop build deploy

Configure with Stripe Payments

Run the following command to setup Stripe payments:

raindrop build stripe start

This will open a browser window with the Stripe configuration process. Follow the instructions in Stripe to complete the setup.

Deploy your application with Stripe Payments

Deploy your application by running the following command:

raindrop build deploy

Your application is now deployed with Stripe Payments. For more information on Stripe Payments visit the Stripe Docs here.

Note

If your user does not have a Stripe account, they will get a 402 error code with the response body containing a payment URL to the Stripe payment page.

Note: paymentUrl is a stripe payment URL with your user’s information populated. We recommend you make this link accessible to the user by either a browser redirect or a manual link that they can click.

response.json

{
  "error": "Payment Required",
  "paymentUrl": "<STRIPE_PAYMENT_URL_FOR_YOUR_USER>"
}

Best Practices for Stripe Integration with Raindrop and WorkOS

WorkOS JWT Template Configuration

For payment verification to work efficiently, you must configure the WorkOS JWT template to include user metadata.

Steps:

1. Go to your WorkOS Dashboard: https://dashboard.workos.com
2. Navigate to Authentication → Session → JWT Template and click Manage
3. Replace the default template with the following:

JWT Template

{
  "id": {{user.id}},
  "email": {{user.email}},
  "first_name": {{user.first_name}},
  "last_name": {{user.last_name}},
  "external_id": {{user.external_id}},
  "metadata": {{user.metadata}}
}