See also the Braintree_MerchantAccount response object.

PHP
$merchantAccountParams = [
  'individual' => [
    'firstName' => 'Jane',
    'lastName' => 'Doe',
    'email' => 'jane@14ladders.com',
    'phone' => '5553334444',
    'dateOfBirth' => '1981-11-19',
    'ssn' => '456-45-4567',
    'address' => [
      'streetAddress' => '111 Main St',
      'locality' => 'Chicago',
      'region' => 'IL',
      'postalCode' => '60622'
    ]
  ],
  'business' => [
    'legalName' => 'Jane\'s Ladders',
    'dbaName' => 'Jane\'s Ladders',
    'taxId' => '98-7654321',
    'address' => [
      'streetAddress' => '111 Main St',
      'locality' => 'Chicago',
      'region' => 'IL',
      'postalCode' => '60622'
    ]
  ],
  'funding' => [
    'descriptor' => 'Blue Ladders',
    'destination' => Braintree_MerchantAccount::FUNDING_DESTINATION_BANK,
    'email' => 'funding@blueladders.com',
    'mobilePhone' => '5555555555',
    'accountNumber' => '1123581321',
    'routingNumber' => '071101307'
  ],
  'tosAccepted' => true,
  'masterMerchantAccountId' => "14ladders_marketplace",
  'id' => "blue_ladders_store"
];
$result = Braintree_MerchantAccount::create($merchantAccountParams);
Parameters
'business'

Only available for Braintree Marketplace accounts. Business information associated with a sub-merchant.

'address' string

Only available for Braintree Marketplace accounts. Business information associated with a sub-merchant.

'locality' string

The locality/city. 255 character maximum.

'postalCode' string

The postal code. Postal code must be a string of 4-9 alphanumeric characters, optionally separated by a dash or a space. Spaces, hyphens, and all other special characters are ignored.

'region' string

The state or province. For PayPal addresses, the region must meet PayPal's state restrictions; for all other payment methods, it must be less than or equal to 255 characters.

'streetAddress' string

The street address. Street address must be less than or equal to 255 characters.

'dbaName' string

The "Doing Business As" name. The company name must contain only letters, numbers, ampersands (&) hyphens (-), exclamation marks (!), at symbols (@), hashtag (#), dollar sign ($), beginning and end parentheses ( '(' and ')' ), single quotation mark ('), period (.), forward slash (/), plus symbol (+), comma (,) and double quotation mark ("). The maximum length is 40 characters.

'legalName' string

The legal name. The applicant's legal name must contain only letters, numbers, ampersands (&) hyphens (-), exclamation marks (!), at symbols (@), hashtag (#), dollar sign ($), beginning and end parentheses ( '(' and ')' ), single quotation mark ('), period (.), forward slash (/), plus symbol (+), comma (,) and double quotation mark ("). The maximum length is 40 characters. Required if tax_id has been provided.

'taxId' string

The 9-digit numeric value associated with the business' tax identity. Required if legal_name has been provided.

'funding' required

Details of where funds will be disbursed for a sub-merchant.

'accountNumber' string

The value representing a checking account number. It is required if the request's funding destination is bank, prohibited otherwise.

'descriptor' string

The value that determines the business description that will appear on a sub-merchant's bank statement for deposits. If one is not provided, the gateway will generate one based on applicant name, business legal name, or DBA name.

'destination' required, string

The way in which funds will be delivered to a specific sub-merchant. Specify either email, mobile_phone, or bank. When email or mobile_phone are specified, Braintree will deposit funds to the Venmo account associated with the provided email address or phone number. When bank is specified, Braintree will deposit funds to the checking account associated with the provided account and routing numbers. Learn more about sub-merchant funding.

'email' string

Email address comprised of ASCII characters.Required if funding destination is email.

'mobilePhone' string

The mobile phone number. Phone must be 10 - 14 characters and can only contain numbers, dashes, parentheses and periods. Required if funding destination is mobile_phone.

'routingNumber' string

The numeric value representing a specific bank. Required if funding destination is bank, prohibited otherwise.

'id' string

Specifies the ID of the sub-merchant, which can be referenced when creating transactions with service fees. 32 character maximum; must be unique, cannot be 'all' or 'new', and must contain only letters, numbers, _ and -. If not provided, Braintree will automatically generate one.

'individual' required

Individual information associated with a sub-merchant.

'address' required, string

Individual address information associated with a sub-merchant.

'locality' required, string

The locality/city. 255 character maximum.

'postalCode' required, string

The postal code. Postal code must be a string of 4-9 alphanumeric characters, optionally separated by a dash or a space. Spaces, hyphens, and all other special characters are ignored.

'region' required, string

The state or province. For PayPal addresses, the region must meet PayPal's state restrictions; for all other payment methods, it must be less than or equal to 255 characters.

'streetAddress' required, string

The street address. Street address must be less than or equal to 255 characters.

'dateOfBirth' required, string

The applicant's date of birth. Values can be passed as YYYYMMDD or YYYY-MM-DD.

'email' required, string

Email address comprised of ASCII characters.

'firstName' required, string

The first name. The first name value must be less than or equal to 255 characters.

'lastName' required, string

The last name. The last name value must be less than or equal to 255 characters.

'phone' string

Phone number. Phone must be 10-14 characters and can only contain numbers, dashes, parentheses and periods.

'ssn' string

Either the full 9-digit Social Security Number or the last 4 digits. The value may be passed with or without dashes. If only the last 4 digits are provided, we will use this information in combination with the sub-merchant's other details to attempt to retrieve the full SSN.

'masterMerchantAccountId' required, string

Specifies the merchant account that service fees are sent to. Merchant account IDs can be viewed in the Control Panel.

'tosAccepted' required, bool

Whether the sub-merchant has read and agreed to the Terms of Service (TOS). See the terms of service accepted parameter for more information.

See also

Still have questions?

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