Skip to main content
Payouts require a verified entity on the paying wallet and a provider configured for server-side flows.

​
Verify the paying entity

A payout settles from the verified person or business the wallet is attributed to, called its entity. That entity must have completed verification:
  • KYC for individuals
  • KYB for organizations
Wallets created for a user are attributed automatically. Wallets created server-side with an app secret are not, even when their owner is a user, so those must have an entity assigned explicitly before a payout can be created.

​
Configure the provider

Register a Bridge API key in the Privy Dashboard under Onramps > Bridge > Configure and enable server-side flows (REST API and server SDKs) for the environment your app is using. Payouts fail if only client-side flows are enabled. See KYC and KYB setup for the full walkthrough. Configure Bridge for server-side flows
Manage these resources through Privy only. Creating, modifying, or deleting the underlying resources directly in the Bridge API or Bridge dashboard can leave Privy and Bridge out of sync and break the integration.

​
Next steps

Register a bank account

Save the bank account a payout settles to

Entities

Learn how wallets are attributed to a verified user or organization