Terms of service acceptance for organizations with Bridge

Bridge requires a signed terms of service agreement before it will create or verify a customer. Privy creates the Bridge customer on the first request and links it to the Privy organization, so your app only ever references the Privy organization ID. Before this step, register a Bridge API key with Privy.

Use the initiateTos 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 tos = await privy.organizations().kyb.initiateTos('<organization-id>', {
  provider: 'bridge',
  environment: 'sandbox',
  email: '[email protected]',
  business_name: 'Acme, Inc.'
});

// tos.link is the terms of service link to pass to your frontend

Pass the link to your app’s frontend so the organization’s representative can accept the terms of service. The request is idempotent: calling it again for the same organization returns a link for the existing Bridge customer.

Next steps

Hosted KYB

Send the organization through Bridge’s hosted verification flow

Headless KYB

Submit verification data from your server