Nova pay

Nova.Pay Medusa Plugin

A Medusa V2 plugin to integrate Nova.Pay into your store.

Features

• Payment Providers:
  • Credit Card (nova-pay-credit-card)
  • Pix (nova-pay-pix)
  • Boleto (nova-pay-bank-slip)
• Product Sync: Automatically syncs products to Nova.Pay whenever a product is created or updated in Medusa.

Installation

Install the package via npm or yarn:

1npm install @novamoney/nova-pay
2# or
3yarn add @novamoney/nova-pay

Configuration

Environment Variables

Add the following environment variables to your .env file:

1NOVA_PAY_API_KEY=your_api_key_here
2NOVA_PAY_CART_PAGE_ID=your_cart_page_uuid_here
3NOVA_PAY_SUBDOMAIN=your_nova_pay_subdomain_here
4NOVA_PAY_VERBOSE=true      # Optional: enables sync logging

Medusa Config

Enable the plugin in your medusa-config.ts file:

1// medusa-config.ts
2
3module.exports = defineConfig({
4  // ...
5  plugins: [
6    // ... other plugins
7    {
8      resolve: "@novamoney/nova-pay",
9      options: {
10        apiKey: process.env.NOVA_PAY_API_KEY,
11        subdomain: process.env.NOVA_PAY_SUBDOMAIN
12      },
13    },
14  ],
15  // ...
16  modules: [
17    // ... other modules
18    {
19      resolve: "@medusajs/medusa/payment",
20      options: {
21        providers: [
22          {
23            resolve: "@novamoney/nova-pay/providers/payment",
24            id: "nova-pay",
25            options: {
26              apiKey: process.env.NOVA_PAY_API_KEY,
27              cartPageId: process.env.NOVA_PAY_CART_PAGE_ID,
28              subdomain: process.env.NOVA_PAY_SUBDOMAIN
29            }
30          },
31        ]
32      }
33    }
34  ]
35});

Client-side Integration

When you initiate a payment using one of the Nova.Pay providers, the response will include a link in the data object of the payment session. You must redirect the customer to this URL to complete the payment.

Example (Next.js Storefront)

1const handlePayment = async (paymentSession) => {
2  if (paymentSession.data.link) {
3    // Redirect to Nova.Pay checkout
4    window.location.href = paymentSession.data.link;
5  }
6};

License

Licensed under the MIT License.