Category

Payment

Version

1.2.1

Last updated

May 29, 2024, 15:35:40 PM6 months ago

MEDUSA-PAYMENT-RAZORPAY

Support the Medusa-Payment-Razorpay Plugin - Elevate Our Medusa Community!

Dear Developers and E-commerce Enthusiasts,
Are you ready to revolutionize the world of online stores with MedusaJS? We have an exciting opportunity that will make payment processing a breeze for our beloved Medusa platform! Introducing the Medusa-Payment-Razorpay plugin, a community-driven project that brings the immensely popular RAZORPAY payment gateway to our MedusaJS commerce stack.
What's in it for You:
🚀 Streamline Payment Processing: With Medusa-Payment-Razorpay, you can unleash the full potential of Razorpay's features, ensuring seamless and secure payments for your customers.
🌐 Global Reach: Engage with customers worldwide, as Razorpay supports various currencies and payment methods, catering to a diverse audience.
🎉 Elevate Your Medusa Store: By sponsoring this plugin, you empower the entire Medusa community, driving innovation and success across the platform.

Installation Made Simple

No hassle, no fuss! Install Medusa-Payment-Razorpay effortlessly with npm:
npm install medusa-payment-razorpay
[RAZORPAY](https://razorpay.com) an immensely popular payment gateway with a host of features.
This plugin enables the razorpay payment interface on [medusa](https://medusajs.com) commerce stack
## Installation
Use the package manager npm to install medusa-payment-razorpay.
bash npm install medusa-payment-razorpay
## Usage
Register for a razorpay account and generate the api keys
In your environment file (.env) you need to define
RAZORPAY_ID=RAZORPAY_SECRET=RAZORPAY_ACCOUNT=
You need to add the plugin into your medusa-config.js as shown below
const plugins = [ ..., { resolve:Copy to clipboardmedusa-payment-razorpay, options:{ key_id: process.env.RAZORPAY_ID, key_secret: process.env.RAZORPAY_SECRET, razorpay_account: process.env.RAZORPAY_ACCOUNT,
automatic_expiry_period: 30, /any value between 12 minutes and 30 days expressed in minutes/ manual_expiry_period: 20, refund_speed: "normal", webhook_secret: process.env.RAZORPAY_SECRET, } }, ...]
## Client side configuration
For the NextJs start you need to make the following changes
1. Install package to your next starter. This just makes it easier, importing all the scripts implicitly
yarn add react-razorpay
2. Create a button for Razorpay <next-starter>/src/modules/checkout/components/payment-button/razorpay-payment-button.tsx
like below
` import { Button } from "@medusajs/ui" import { Cart,PaymentSession } from "@medusajs/medusa" import Spinner from "@modules/common/icons/spinner" import React, { useCallback, useState } from "react" import useRazorpay, { RazorpayOptions } from "react-razorpay"
const RazorpayPaymentButton = ({ session, notReady, cart }: { session: PaymentSession notReady: boolean cart: Omit<Cart, "refundable_amount" | "refunded_total"> }) => { const [disabled, setDisabled] = useState(false) const [submitting, setSubmitting] = useState(false) const [errorMessage, setErrorMessage] = useState(undefined) const [Razorpay] = useRazorpay();
const orderData = session.data as Record<string, string> const onPaymentCompleted = async () => { await placeOrder().catch(() => { setErrorMessage("An error occurred, please try again.") setSubmitting(false) }) }
const handlePayment = useCallback(() => { const options: RazorpayOptions = { callback_url: Copy to clipboard${process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL}/razorpay/hooks, key: process.env.NEXT_PUBLIC_RAZORPAY_KEY ?? '', amount: session.amount.toString(), order_id: orderData.id, currency: cart.region.currency_code.toLocaleUpperCase(), name: process.env.COMPANY_NAME ?? "your company name ", description: Copy to clipboardOrder number ${orderData.id},
image: "https://example.com/your_logo",
modal: {
backdropclose: true,
escape: true,
handleback: true,
confirm_close: true,
ondismiss: () => {
setSubmitting(false)
},
animation: true,
},
handler: async (args) => {
onPaymentCompleted()
},
"prefill": {
"name": cart?.billing_address.first_name + " " + cart?.billing_address.last_name,
"email": cart?.email,
"contact": (cart?.shipping_address?.phone) ?? undefined
},
"notes": {
"address": cart?.billing_address,
"order_notes": session.data.notes
},
};
const razorpay = new Razorpay(options);
razorpay.open();
razorpay.on("payment.failed", function (response: any) {
setErrorMessage(JSON.stringify(response.error))
})
razorpay.on("payment.authorized", function (response: any) {
})
razorpay.on("payment.captured", function (response: any) {
}
)
}, [Razorpay]); return ( <
<Button
disabled={submitting || notReady}
onClick={handlePayment}
{submitting ? <Spinner /> : "Checkout"}
</Button>
{errorMessage && (
<div className="text-red-500 text-small-regular mt-2">
{errorMessage}
</div>
)}
</>
)
}
Step 3.
nextjs-starter-medusa/src/lib/constants.tsx
add
```
razorpay: {
title: "Razorpay",
icon: <CreditCard />,
},
step 4.add into the payment element <next-starter>/src/modules/checkout/components/payment-button/index.tsx
case "razorpay": return
Step 4. Add enviroment variables in the client
NEXT_PUBLIC_RAZORPAY_KEY: NEXT_PUBLIC_SHOP_NAME: NEXT_PUBLIC_SHOP_DESCRIPTION:

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.

License

Untested features

These features exists, but without implementing the client it isn't possible to tests these outright
  1. Capture Payment
  2. Refund

Disclaimer

The code was tested on limited number of usage scenarios. There maybe unforseen bugs, please raise the issues as they come, or create pull requests if you'd like to submit fixes.

Support the Medusa-Payment-Razorpay Plugin - Strengthen Our Medusa Community!

Dear Medusa Enthusiasts,
I hope this message finds you all in high spirits and enthusiasm for the world of e-commerce! Today, I reach out to our vibrant Medusa community with a heartfelt appeal that will strengthen our collective journey and elevate our online stores to new heights. I am thrilled to present the Medusa-Payment-Razorpay plugin, a community-driven project designed to streamline payment processing for our beloved Medusa platform.
As a dedicated member of this community, I, SGFGOV, have invested my time and passion into crafting this valuable plugin that bridges the gap between online retailers and their customers. It is with great humility that I invite you to participate in this open-source initiative by sponsoring the Medusa-Payment-Razorpay plugin through GitHub.
Your sponsorship, no matter the size, will make a world of difference in advancing the Medusa ecosystem. It will empower me to focus on the continuous improvement and maintenance of the Medusa-Payment-Razorpay plugin, ensuring it remains reliable, secure, and seamlessly integrated with Medusa.
Being a community plugin, perks are not the focus of this appeal. Instead, I promise to give back to the community by providing fast and efficient support via Discord or any other means. Your sponsorship will help sustain and enhance the plugin's development, allowing me to be responsive to your needs and address any concerns promptly.
Let's come together and demonstrate the power of community collaboration. By sponsoring the Medusa-Payment-Razorpay plugin on GitHub, you directly contribute to the success of not only this project but also the broader Medusa ecosystem. Your support enables us to empower developers, merchants, and entrepreneurs, facilitating growth and success in the world of e-commerce.
To show your commitment and be part of this exciting journey, kindly consider sponsoring the Medusa-Payment-Razorpay plugin on GitHub. Your contribution will amplify the impact of our community and foster a supportive environment for all.
Thank you for your time, and thank you for being an integral part of our Medusa community. Together, we will elevate our online stores and create extraordinary experiences for customers worldwide.
With warm regards,
SGFGOV Lead Developer, Medusa-Payment-Razorpay Plugin for Medusa

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.