Merchant Account
Merchant Account: Create
See also the Merchant Account 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 = $gateway->merchantAccount()->create($merchantAccountParams);Parameters
'accountNumber'string'extendedAddress'string'locality'string'postalCode'string'region'string'streetAddress'string'companyName'string'dateOfBirth'string'email'string'firstName'string'lastName'string'phone'string'routingNumber'string'ssn'string'taxId'string'address'string'locality'string'postalCode'string'region'string'streetAddress'string'dbaName'stringThe "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 ("). 40 character maximum.
'legalName'stringThe 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 ("). 40 character maximum. Required if business information has been provided.
'taxId'string'accountNumber'stringThe value representing a checking account number. Required if the request's funding destination is bank, prohibited otherwise.
'descriptor'string'destination'stringThe way in which funds will be delivered to a specific sub-merchant. Specify bank to disburse funds into the checking account associated with the provided account and routing numbers. Venmo funding destinations, email and mobilePhone, are no longer supported for new merchants. Contact us with questions or concerns.
'email'stringThe email address composed of ASCII characters. Must be in the format email_name@email_domain.domain. 64 character maximum for email_name. Required if the request's funding destination is email.
'mobilePhone'stringThe mobile phone number. Phone must be 10 - 14 characters and can only contain numbers, hyphens and parentheses. Required if the request's funding destination is mobilePhone.
'routingNumber'stringThe numeric value representing a specific bank. Required if funding destination is bank, prohibited otherwise.
'id'stringSpecifies the ID of the sub-merchant, which can be referenced when creating transactions with service fees. 32 character maximum; must be unique, can't be 'all' or 'new', and must contain only letters, numbers, _ and -. If not provided, we will automatically generate one.
'address'string'locality'string'postalCode'string'region'string'streetAddress'string'dateOfBirth'stringYYYYMMDD or YYYY-MM-DD.'email'string'firstName'string'lastName'string'phone'string'ssn'stringSpecifies the merchant account that service fees are sent to. Merchant account IDs can be viewed in the Control Panel; learn how in our support articles.
'tosAccepted'boolWhether the sub-merchant has read and agreed to the Terms of Service (TOS). See the terms of service accepted parameter for more information.