You will need to onboard your Braintree Marketplace sub-merchants via the Braintree API; the Control Panel does not offer this capability. Braintree 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.

important

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 Braintree's 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.

1099-Ks

Braintree 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.

note

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

Still have questions?

If you can’t find an answer, contact our Support team.


← Back to Previous Page