In order to create a new sub-merchant account, you will need to first collect certain information about the applicant and their business. You'll then use this information to onboard the new sub-merchant via the Braintree API; the Control Panel does not offer this capability. We will verify the sub-merchant data and confirm the sub-merchant’s status via a webhook. After that, you will be responsible for supporting your sub-merchants and ensuring that they deliver products or services that don’t break any laws.

Collecting sub-merchant data

The type of onboarding information you collect from your sub-merchants depends on how you plan to use Braintree Marketplace. For example, if you collect your sub-merchant's bank account information, funds will be disbursed into their bank account; if you choose to collect an email address or mobile phone number instead, funds will be disbursed via Venmo.


Sub-merchants must have or create a Venmo account in order to receive funds via Venmo. We recommend letting your sub-merchants know about this requirement during onboarding to avoid confusion during funding. Learn more about Braintree Marketplace funding.

Sub-merchant data parameters

Required parameters

  • First Name
  • Last Name
  • Address
  • DOB
  • Email: If you plan to disburse sub-merchant funds to Venmo via email address, the email address provided must match the sub-merchant's Venmo account.

Optional parameters

  • Business Name: This is only required if a Tax ID is provided instead of a SSN.
  • Mobile Phone: This is only required if you plan to disburse sub-merchant funds to Venmo via phone number.
  • SSN or Tax ID: You can collect the full number, last 4 digits, or nothing at all. It is up to you whether you want to collect each sub-merchant’s full SSN (Social Security Number) or Tax ID during the onboarding process; sub-merchants can process up to 200 transactions or $20,000 in total transaction volume without providing this information. If you expect your sub-merchants to exceed these thresholds, however, we recommend collecting the full SSN or Tax ID upfront, as you'll need to distribute 1099-K tax forms to these sub-merchants come tax season.
  • Routing Number: This is only required if you plan to disburse sub-merchant funds to a bank account.
  • Account Number: This is only required if you plan to disburse sub-merchant funds to a bank account.*

*The account submitted must be a checking account. Savings, deposit-only, and prepaid debit accounts will not be accepted.

Merchant agreement

In order to accept payments, your sub-merchants will need to accept our merchant agreements. To facilitate this, you'll need to add a short passage of text to your website's existing Terms of Service, which will allow your sub-merchants to agree to both your terms and ours at the same time. You can find the required text and learn more in our developer docs.


We will provide you with pre-generated 1099-K tax forms for all of your sub-merchants who met both of the following thresholds within the year:

  • Processed more than 200 transactions
  • Processed at least $20,000 in total transaction volume (excluding service fees*)

*Example: A sub-merchant sells a $100 item and the service fee is $10. The transaction volume generated by this sale is $90.


While we file these forms with the IRS, it will be your responsibility to distribute them to your sub-merchants.