Stripe

Receive payments on your Medusa commerce application using Stripe.

Stripe Plugin Documentation | Medusa Website | Medusa Repository

Features

• Authorize payments on orders from any sales channel.
• Support for Bancontact, BLIK, giropay, iDEAL, and Przelewy24.
• Capture payments from the admin dashboard.
• View payment analytics through Stripe's dashboard.
• Ready-integration with Medusa's Next.js starter storefront.
• Support for Stripe Webhooks.

Prerequisites

• Medusa backend
• Stripe account

How to Install

1. Run the following command in the directory of the Medusa backend:

npm install medusa-payment-stripe

2. Set the following environment variables in .env:

STRIPE_API_KEY=sk_...
# only necessary for production
STRIPE_WEBHOOK_SECRET=whsec_...

3. In medusa-config.js add the following at the end of the plugins array:

const plugins = [
  // ...
  {
    resolve: `medusa-payment-stripe`,
    options: {
      api_key: process.env.STRIPE_API_KEY,
      webhook_secret: process.env.STRIPE_WEBHOOK_SECRET,
    },
  },
]

Test the Plugin

1. Run the following command in the directory of the Medusa backend to run the backend:

npm run start

2. Enable Stripe in a region in the admin. You can refer to this User Guide to learn how to do that. Alternatively, you can use the Admin APIs.

3. Place an order using a storefront or the Store APIs. You should be able to use Stripe as a payment method.

Additional Resources

• Stripe Plugin Documentation