SDKs

TypeScript SDK for the public merchant API

The NITY0X SDK is the first-party TypeScript client for the public merchant API documented in OpenAPI. It keeps integrations compact: create payments, replay webhooks, list balances, and verify signatures without hand-rolling request plumbing.

Install

bash

npm i @nity0x/sdk

What it covers

Payments, payouts, payment links, webhooks, and balances
Typed request/response helpers with idempotency support
Webhook signature parsing and verification helpers
OpenAPI-checked method + path coverage in the repository

Quickstart

Use the client against your API key, then verify the signed webhook payload with the matching helper.

tsquickstart.ts

import { Nity0xClient, verifyWebhookSignature } from "@nity0x/sdk";

const client = new Nity0xClient({
  apiKey: process.env.NITY0X_API_KEY!,
  baseUrl: "https://api.nity0x.io",
});

const payment = await client.payments.create(
  { amount: "25.000000", chain: "eth" },
  { idempotencyKey: "order_001" },
);

const ok = verifyWebhookSignature(
  rawBody,
  req.headers.get("nityox-signature") ?? "",
  process.env.NITY0X_WEBHOOK_SECRET!,
);