Skip to main content

The Power of Headless KYC

· One min read
Ha-Shem Team
Ha-Shem Team
Spidify Developers

When building a user onboarding flow, branding and user experience are everything. A jarring transition to a third-party KYC provider can result in drop-offs.

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!