Nova pay

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:

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

Configuration

Environment Variables

Add the following environment variables to your .env file:

NOVA_PAY_API_KEY=your_api_key_here
NOVA_PAY_CART_PAGE_ID=your_cart_page_uuid_here
NOVA_PAY_SUBDOMAIN=your_nova_pay_subdomain_here
NOVA_PAY_VERBOSE=true      # Optional: enables sync logging

Medusa Config

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

// medusa-config.ts

module.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
            }
          },
        ]
      }
    }
  ]
});

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)

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

License

Licensed under the MIT License.