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

How to Install

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

1
npm install medusa-payment-stripe-subscription

2. Set the following environment variables in .env:

1234
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:

12345678910
const plugins = [
    // ...
    {
        resolve: `medusa-payment-stripe-subscription`,
        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:

1
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

Build your own plugins

Develop your own plugins with our API to speed up your processes.

Make your plugin available via npm for it to be shared in our Plugin Library with the broader Medusa community.

Built by

Category

Version