TypeScript SDK

npm install @zeammoney/sdk

import { Client, Environment } from "@zeammoney/sdk";

const client = new Client({ environment: Environment.Production });

import { loginOTP } from "@zeammoney/sdk/recipes";

const session = await loginOTP(client, {
  mobileNumber: "+27821234567",
  askCode: async (hint) => {
    return prompt(`OTP sent to ${hint.maskedDestination}`)!;
  },
});
// session is on TrackBusiness and persisted in the token store

import { connectLogin } from "@zeammoney/sdk/recipes";

const session = await connectLogin(client, {
  stellarSeed: seed,       // from your secret manager
  publicKey: publicKey,
});
// session is on TrackConnect — keypair zeroed after authentication

// List associations
const associations = await client.business().listAssociations(session);

// Get a wallet
const wallet = await client.business().getWallet(session, walletId);

// Query connectors
const connectors = await client.connect().queryConnectors(connectSession, {
  countryISO: "ZA",
  method: "BANK",
});

import { ZeamError, ErrorKind } from "@zeammoney/sdk";

try {
  const result = await client.business().listAssociations(session);
} catch (err) {
  if (err instanceof ZeamError) {
    if (err.kind === ErrorKind.Auth) {
      // Token expired — re-authenticate
    }
    if (err.kind === ErrorKind.Transient) {
      // Retry with backoff
    }
    console.error(`Error: ${err.code} (request_id=${err.requestId})`);
  }
}

import { verifyWebhook } from "@zeammoney/sdk/webhooks";

const event = verifyWebhook(requestBody, {
  signature: headers["x-zeam-signature"],
  secret: webhookSecret,
  maxAge: 300, // reject events older than 5 minutes
});