For months, we've been working on standardizing how developers integrate Spidify KYC workflows into their applications. With this release, we're providing a modular, production-ready toolkit designed for both speed and flexibility.

Why a SDK?​

Previously, developers had to manually handle API calls, session tokens, state transitions, and UI components. It worked, but it took time.

Now, with our SDK, you have two amazing options:

1. Managed UI: Drop an iframe into your app in less than 5 minutes.
2. Headless Engine: Build your own completely custom interface while we handle the complex backend orchestration and API state machine.

We can't wait to see what you build! Check out our Getting Started guide to dive in.

That's why we built the Headless Engine (KycSDK) into our new TypeScript SDK.

Total Control​

Unlike traditional iframe embeds, a headless architecture gives you the raw API orchestration logic without any UI constraints.

You can:

• Render forms exactly how your design team envisions them.
• Insert your own intermediate steps (like asking for a referral code) directly inside the KYC flow.
• Maintain a single-page application feel without any clunky redirects.

Using our event-driven system, you simply listen for step changes:

sdk.on('step_started', (event) => {
  if (event.step === 'otp-verification') {
    // Show your pixel-perfect custom OTP input
    renderCustomOtpComponent();
  }
});

It's the ultimate flexibility for engineering teams that demand perfection. Read more about it in our Core Features documentation!