TypeScript / Node.js SDK

npm install @finsel-dgi/pasby

import { Pasby } from "@finsel-dgi/pasby";

const pasby = new Pasby({
  apikeyAuth: "bk-test_YOUR_KEY",
  appSecretKey: "YOUR_APP_SECRET",
  basePath: "https://s.pasby.africa", // sandbox
  version: "v2", // default; only v2 is typed
});

const { data } = await pasby.identification.wildcard({
  action: "signup",
  claims: ["naming.given", "contact.email"],
  seeds: 4,
  payload: "Create your account",
});

console.log(data.status); // e.g. "successful"
console.log(data.data.request.id); // flow id for ping
console.log(data.data.seeds); // QR seeds (wildcard)

const { data: ping } = await pasby.flows.ping({
  request: data.data.request.id,
});

import { Pasby, PasbyError } from "@finsel-dgi/pasby";

try {
  await pasby.identification.differentDevice({ /* ... */ });
} catch (err) {
  if (err instanceof PasbyError) {
    console.error(err.status, err.message);
  }
}

import { Pasby } from "@finsel-dgi/pasby";

const pasby = new Pasby({
  apikeyAuth: process.env.PASBY_API_KEY!,
  appSecretKey: process.env.PASBY_APP_SECRET!,
  basePath: "https://s.pasby.africa",
});

// 1. Start identification
const { data: start } = await pasby.identification.wildcard({
  action: "signup",
  claims: ["naming.given", "contact.email"],
  seeds: 4,
  payload: "Create your account",
});

const flowId = start.data.request.id;

// 2. Poll until complete (simplified)
let done = false;
while (!done) {
  const { data: ping } = await pasby.flows.ping({ request: flowId });
  const req = ping.data.request;
  if (req.cancelled || req.signature) done = true;
  else await new Promise((r) => setTimeout(r, 2000));
}

// 3. Decrypt claims on your server — see Handling encrypted claims guide