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

123
npm install @tax1driver/medusa-payu
# or
yarn add @tax1driver/medusa-payu

Configuration

Add the payment provider configuration to your Copy to clipboardmedusa-config.ts:

1234567891011121314151617181920
modules: [
  // ... 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

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 Copy to clipboardinitiatePaymentSession call in order to create a PayU transaction:

1234
const payuData = {
  customer_ip: string;
  email: string;
}

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.

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

Webhook Configuration

The webhook endpoint is automatically registered at Copy to clipboard/hooks/payment/payu. Ensure that:

• Your Copy to clipboardcallbackUrl points to this endpoint (e.g., Copy to clipboardhttps://yourdomain.com/hooks/payment/payu)
• The endpoint is publicly accessible
• Your firewall allows incoming requests from PayU's servers

Refunds

Refunds can be processed through Medusa's admin panel or API. The plugin will:

• Create a refund request with PayU
• Process partial or full refunds
• Update the order status in Medusa accordingly

You can customize the refund description using the Copy to clipboardrefundDescription option in the plugin configuration.