Installation

Prerequisites

• Node.js 22 or newer. The SDK relies on the platform fetch, FormData, and crypto.timingSafeEqual and is published as "engines": { "node": ">=22" }.
• An API key. Sandbox keys are prefixed sk_test_ and route automatically to https://sandbox-api.itseasy.co/v1/api; live keys (any other prefix) route to https://api.itseasy.co/v1/api. Never expose either key to the browser.
• TypeScript 5+ if you want types — the package ships .d.ts and .d.cts declarations side-by-side with the JS bundles.

Install the package

npm install @easylabs/node

Verify the install

import { createClient } from "@easylabs/node";

const easy = await createClient({ apiKey: process.env.EASY_API_KEY! });

const customers = await easy.getCustomers({ limit: 1 });
console.log(`Connected. ${customers.data.length} customer(s) returned.`);

createClient validates the API key against /validate-key before returning, so a bad key fails fast at startup rather than on the first request.

Next steps

• Quickstart — render your first payment.
• Authentication — key handling, multi-tenant patterns.
• Webhooks — verify inbound deliveries.