Skip to main content
Business customers complete Know Your Business verification inside the Etherfuse app. As a partner, you don’t drive KYB through the API. You authenticate the user with a kyb-scoped JWT and launch them into the app’s KYB flow. The app collects everything and walks them through it.
This builds directly on JWT User Authentication; read that first. KYB is just that flow with scope: kyb and a target of /kyb.
1

Sign a JWT with the kyb scope

Sign a user JWT exactly as in JWT User Authentication, with the scope claim set to kyb. The sub (and email, name) identify the person signing in, not the business; the business has its own org id (see the sub note).
import jwt from "jsonwebtoken";
import { randomUUID } from "crypto";

const token = jwt.sign(
  { scope: "kyb", nonce: randomUUID(), email: "[email protected]", name: "Ana García" },
  PRIVATE_KEY,
  {
    algorithm: "RS256",
    keyid: "your-key-id",
    issuer: "https://your-domain.com",
    subject: userId,   // the person signing in
    audience: "https://api.sand.etherfuse.com/auth/token",
    expiresIn: "5m",
  },
);
2

Launch the user to /kyb

POST a form to /auth/launch with target=/kyb. Remember this is on the app host, not the API host.
<form method="POST" action="https://sandbox.etherfuse.com/auth/launch">
  <input type="hidden" name="grant_type" value="urn:ietf:params:oauth:grant-type:jwt-bearer" />
  <input type="hidden" name="assertion" value="<kyb_scoped_jwt>" />
  <input type="hidden" name="target" value="/kyb" />
</form>
3

Wait for approval

The user completes KYB in the app. Once the business is approved, it can transact.
Today, the customer creates their own business. When they reach /kyb, the app prompts them for their company name and creates a new business, then walks them through KYB.Coming very soon: set up a business ahead of time, manage its members, monitor your users’ KYB progress, and subscribe to a business-status webhook (the existing customer_updated webhook only covers individual KYC, not KYB).
That’s the whole integration. The forms, document collection, and review all live in the Etherfuse app.