Node.js SDK Quick Start

npm install @lavapayments/nodejs

import { Lava } from '@lavapayments/nodejs';

const lava = new Lava(process.env.LAVA_SECRET_KEY!, {
  apiVersion: '2025-04-28.v1'
});

import { Lava } from '@lavapayments/nodejs';

const lava = new Lava(process.env.LAVA_SECRET_KEY!, {
  apiVersion: '2025-04-28.v1'
});

// Step 1: Create a checkout session for a new customer
const session = await lava.checkoutSessions.create({
  checkout_mode: 'onboarding',
  origin_url: 'https://yourapp.com',
  reference_id: 'user_123' // Your internal user ID
});

console.log('Checkout token:', session.checkout_session_token);
// Pass this token to your frontend to display the checkout UI

// Step 2: User completes payment on frontend
// (Use @lavapayments/checkout React library - not covered here)

// Step 3: After checkout completes, get the connection
const connections = await lava.connections.list({
  reference_id: 'user_123',
  limit: 1
});
const connection = connections.data[0];

// Step 4: Generate forward token for AI requests
const forwardToken = lava.generateForwardToken({
  connection_secret: connection.connection_secret,
  product_secret: process.env.LAVA_PRODUCT_SECRET!
});

// Step 5: Make an AI request through Lava's proxy
const response = await fetch(lava.providers.openai + '/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${forwardToken}`
  },
  body: JSON.stringify({
    model: 'gpt-4o-mini',
    messages: [
      { role: 'system', content: 'You are a helpful assistant.' },
      { role: 'user', content: 'Hello!' }
    ]
  })
});

const data = await response.json();
console.log('AI response:', data);

// Step 6: Check usage and balance
const updatedConnection = await lava.connections.retrieve(connection.connection_id);
console.log('Remaining balance:', updatedConnection.wallet.balance);

# Required
LAVA_SECRET_KEY='aks_your_secret_key_here'

# Optional - needed for product-specific pricing
LAVA_PRODUCT_SECRET='your_product_secret_here'