Get Started with Podium

npm install @podiumcommerce/node-sdk

# or with yarn
yarn add @podiumcommerce/node-sdk

# or with bun
bun add @podiumcommerce/node-sdk

import { createPodiumClient } from '@podiumcommerce/node-sdk'

// Option 1: Pass the API key directly
const client = createPodiumClient({
  apiKey: 'podium_live_your-api-key',
})

// Option 2: Use environment variable
// Set PODIUM_API_KEY in your .env file
const client = createPodiumClient()

const products = await client.product.list({
  page: 1,
  limit: 20,
})

console.log(products)
// {
//   data: [{ id: '...', title: '...', price: 29.99, ... }],
//   total: 150,
//   page: 1
// }

const user = await client.user.create({
  requestBody: {
    email: 'customer@example.com',
    privyId: 'did:privy:xxx', // From Privy auth
  },
})

console.log(user.id) // 'user_abc123'

const order = await client.userOrder.create({
  id: user.id,
  requestBody: {
    productId: 'product_xyz',
    quantity: 1,
  },
})

console.log(order)
// { id: 'order_...', status: 'pending', items: [...] }

import { ApiError } from '@podiumcommerce/node-sdk'

try {
  const products = await client.product.list({ page: 1 })
} catch (error) {
  if (error instanceof ApiError) {
    console.error(`API Error ${error.status}: ${error.message}`)
    console.error('Response:', error.body)
  }
  throw error
}