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:

``bash
npm install medusa-payment-stripe
`

2\. Set the following environment variables in .env:

`bash
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:

`js
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:

`bash
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