KYB for organizations with Bridge

Privy verifies an organization with Bridge. Privy creates the Bridge business customer on the first request and links it to the Privy organization, so your app only ever references the Privy organization ID. Before creating a KYB link, see hosted terms of service or, if Bridge has approved your app, terms of service reliance for how to collect an authorized representative’s acceptance. The representative then submits the organization’s information through a hosted verification flow. To collect that data in your own interface instead, see headless KYB. Before verifying organizations, register a Bridge API key with Privy.

Bridge reviews business customers manually, so KYB usually takes longer than KYC for an individual. Bridge may also require the organization’s associated persons to complete their own verification.

Create a KYB link

Use the initiateLinks method from the kyb resource on organizations().

import {PrivyClient} from '@privy-io/node';

const privy = new PrivyClient({
  appId: process.env.PRIVY_APP_ID!,
  appSecret: process.env.PRIVY_APP_SECRET!
});

const status = await privy.organizations().kyb.initiateLinks('<organization-id>', {
  provider: 'bridge',
  environment: 'sandbox',
  email: '[email protected]',
  business_name: 'Acme, Inc.',
  endorsements: ['base'],
  redirect_uri: 'https://your-app.com/kyb/complete'
});

// status.kyb.link is the hosted KYB link to pass to your frontend

Pass kyb.link to your app’s frontend so the organization’s representative can complete verification. The request is idempotent: calling it again for the same organization returns the existing link.

Track KYB status

Verification is asynchronous. Bridge reviews the submission after the representative completes the hosted flow, and can revoke an endorsement later. See track KYB status to poll an organization’s status or subscribe to webhooks.

Next steps

Track KYB status

Poll an organization’s verification status or subscribe to webhooks

Headless KYB

Submit an organization’s verification data from your server

Organization wallets

Create wallets an organization’s members can operate together

Handling webhook events

Configure an endpoint to receive Privy webhook events

KYC and KYB

Users

Organizations

Hosted link

Create a KYB link

Track KYB status

Next steps

Track KYB status

Headless KYB

Organization wallets

Handling webhook events

​Create a KYB link

​Track KYB status

​Next steps

Track KYB status

Headless KYB

Organization wallets

Handling webhook events

Create a KYB link

Track KYB status

Next steps