Receiving Royalty Splits
Overview
As part of Royalty Splits, we've made it easy for payees to receive their royalties in USDC using either an auto-generated Royalty Vault or their own connected Wallet. Your payees can either create a new wallet using Web3Auth (a password-less, email-based wallet creation service), or connect an existing, self-custody wallet (like MetaMask) to their portal account. This article will step through what happens when a Royalty Vault is created( as part of Royalty Split creation), and how Payees can connect their wallet and claim their balance.
Prerequisites
Talk with our customer support team about enabling Royalty Splits for your account.
Your user account must have "Editor" permissions for Catalog & Asset Management and Royalty Accounting.
Tracks you intend use must meet the following requirements:
How To: Receive a Royalty Split
Add Payees To a Royalty Split
When creating Royalty Splits, you must add payees and assign their split % as you would in a regular contract. The only extra input is whether or not the payee has a wallet address connected to their account.
If a payee already has a wallet, great – their wallet address will be automatically used.
If a payee doesn't have a wallet, a Royalty Vault is created onchain to store their split until they create or connect a wallet themselves.
If you know the payees wallet address, you can add it manually to their account details, but be aware only the payee can update this wallet address after the Royalty Split is created.


Payee Receives an Email Notification
After the Royalty Split has been created successfully:
Payees will receive an email notifying them about the split % they've received for an asset.
If a Royalty Vault was auto-created for them, they’ll receive a second email with instructions on how they can claim the split % from their Payee Portal.
Payee Creates or Connects a Wallet
In the Payee Portal, payees have two options to add a wallet:
Create a wallet using their email
Payees confirm their email address and then receive a secure verification code (2FA) to confirm it and create their wallet.
This approach is simpler than having to handle 12-word seed phrases, making it perfect for anyone new to web3 digital wallets.
Connect their existing wallet
If a payee already uses a wallet, they can connect it directly via our 3rd-party wallet providers (ie MetaMask, WalletConnect, Coinbase etc).
This is great for payees who are already comfortable managing their own wallet keys.


To get started, Payees simply click Claim from their Royalty Vault balance on their Payee Portal or Connect Wallet at any time from their payee settings. Once the wallet is connected, the wallet’s 0x address is saved into the payee’s account details for all future onchain royalties and splits to be sent.
Claiming Royalty Splits from the Payee Vault
Once the payee has a wallet connected they can proceed in claiming their Royalty Splits and any funds stored.
To claim, payees will need to retrieve the Royalty Vault Key from the email that was sent to them when their vault was created.


Their Vault Key is single-use only. Once they reveal their key, they will not be able to access it a second time, and we’re unable to resend it.
If a payee is unable to retrieve their Royalty Vault Key, please contact [email protected] for assistance to re-send their Vault Key.
Once their claim is successful, all future Royalty Splits and USDC payments will be sent directly to the payee’s connected wallet address, and their Royalty Vault will be marked inactive.
Troubleshooting / Expected Outcomes
A Royalty Vault Remains Unclaimed
If a payee doesn’t set up or connect a wallet, their Royalty Splits and any related funds remain safely stored in their Royalty Vault accessible from their Payee Portal account.
Overtime, if their balance remains unclaimed, you as the admin can have their vault balance transferred manually to another 0x address onchain or you can have it moved to traditional payment rails, such as PayPal or Tipalti.
Revelator Wallet
For an enhanced Royalty Split experience, direct your payees to download the Revelator Wallet mobile app.
iOS → Download Android → Download


Frequently Asked Questions
Last updated
Was this helpful?