Payment Providers:
- Credit Card ()
- Pix ()
- Boleto ()
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 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 file:

1// medusa-config.ts
2
3module.exports = defineConfig({
// ...
plugins: [
  // ... other plugins
  {
    resolve: "@novamoney/nova-pay",
    options: {
      apiKey: process.env.NOVA_PAY_API_KEY,
      subdomain: process.env.NOVA_PAY_SUBDOMAIN
    },
  },
],
// ...
modules: [
  // ... other modules
  {
    resolve: "@medusajs/medusa/payment",
    options: {
      providers: [
        {
          resolve: "@novamoney/nova-pay/providers/payment",
          id: "nova-pay",
          options: {
            apiKey: process.env.NOVA_PAY_API_KEY,
            cartPageId: process.env.NOVA_PAY_CART_PAGE_ID,
            subdomain: process.env.NOVA_PAY_SUBDOMAIN
          }
        },
      ]
    }
  }
]
35});

Client-side Integration

When you initiate a payment using one of the Nova.Pay providers, the response will include a in the 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};