Node.js SDK

npm install @minnha/node

import { Minnha } from "@minnha/node";

const minnha = new Minnha(process.env.MINNHA_API_KEY!);

// or with options:
const minnha = new Minnha({
  apiKey: process.env.MINNHA_API_KEY!,
  baseUrl: "https://api.minnha.pay",   // optional
  timeoutMs: 30_000,                   // optional, default 30s
  maxRetries: 2,                       // optional, default 2
});

const session = await minnha.sessions.create({ amount: 100, currency: "SAR" });
await minnha.sessions.retrieve(token);
await minnha.sessions.list({ page: 0, size: 20 });

await minnha.transactions.list({ status: "SUCCESS" });
await minnha.transactions.retrieve(id);                 // { transaction, attempts }
await minnha.transactions.refund(id, { amount: 50 });
await minnha.transactions.capture(id);

// Auto-paginated iteration
for await (const tx of minnha.transactions.iterate({ status: "FAILED" })) {
  console.log(tx.id);
}

await minnha.customers.create({ email: "c@x.com", name: "Customer" });
await minnha.customers.list();
await minnha.customers.retrieve(id);
await minnha.customers.delete(id);

import { Minnha, MinnhaSignatureError } from "@minnha/node";

const event = Minnha.Webhooks.parse(rawBody, signatureHeader, webhookSecret);
// throws MinnhaSignatureError on bad signature

await minnha.sessions.create(
  { amount: 100, currency: "SAR" },
  { idempotencyKey: "ord_123" }
);