Payu

Name: Payu
Author: Tax1driver

Medusa PayU Payment Provider

npm install @tax1driver/medusa-payu

Medusa PayU Payment Provider

MedusaJS | PayU Homepage | PayU Docs | npm

Compatibility

This plugin is compatible with Medusa v2.4.0+.

Overview

This plugin provides PayU payment integration for Medusa commerce platform.

Installation

1npm install @tax1driver/medusa-payu
2# or
3yarn add @tax1driver/medusa-payu

Configuration

Add the payment provider configuration to your :

1modules: [
// ... other modules ...
{
  resolve: "@medusajs/medusa/payment",
  options: {
    providers: [
      {
        resolve: '@tax1driver/medusa-payu/providers/payu',
        options: {
          clientId: process.env.PAYU_CLIENT_ID,
          clientSecret: process.env.PAYU_CLIENT_SECRET,
          merchantPosId: process.env.PAYU_MERCHANT_POS_ID,
          secondKey: process.env.PAYU_SECOND_KEY,
          sandbox: process.env.PAYU_SANDBOX === "true",
          returnUrl: process.env.PAYU_RETURN_URL,
          
          // By default, this should be your backend's base URL + /hooks/payment/payu (e.g. https://example.com/hooks/payment/payu)
          callbackUrl: process.env.PAYU_CALLBACK_URL || `${process.env.APP_BASE_URL}/hooks/payment/payu`,
          
          title: "Payment for order", // Optional
          refundDescription: "Refund", // Optional
        },
      },
    ],
  }
}
27]

Usage

Overview

Once configured, PayU will be available as a payment provider in your Medusa store. The plugin integrates seamlessly with Medusa's payment workflow to handle the complete payment lifecycle.

Required Data

The following data is required from your checkout flow and needs to be provided in the call in order to create a PayU transaction:

1const payuData = {
2  customer_ip: string;
3  email: string;
4}

Payment Flow

When a customer selects PayU as their payment method during checkout, the plugin creates a new transaction with PayU and returns a payment URL.

Redirect: Redirect the customer to the provided PayU payment URL to let them complete the payment on PayU's payment page.
Payment Processing: After completing or canceling the payment, the customer is redirected back to your store via the configured values.
Webhook Notification: PayU sends a webhook notification to your configured endpoint to confirm the payment status. The plugin automatically validates and processes these webhooks.
Order Completion: Based on the webhook data, Medusa updates the payment and order status accordingly.