Terms of service acceptance for users 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 user, so your app only ever references the Privy user ID. Before this step, register a Bridge API key with Privy.

Use the initiateTos method from the kyc resource on users().

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.users().kyc.initiateTos('did:privy:xxxxx', {
  provider: 'bridge',
  environment: 'sandbox',
  email: '[email protected]'
});

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

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

Next steps

Hosted KYC

Send the user through Bridge’s hosted verification flow

Headless KYC

Submit verification data from your server