Merchant Account
Merchant Account: Create
See also the Merchant Account response object.
- Ruby
merchant_account_params = {
:individual => {
:first_name => "Jane",
:last_name => "Doe",
:email => "jane@14ladders.com",
:phone => "5553334444",
:date_of_birth => "1981-11-19",
:ssn => "456-45-4567",
:address => {
:street_address => "111 Main St",
:locality => "Chicago",
:region => "IL",
:postal_code => "60622"
}
},
:business => {
:legal_name => "Jane's Ladders",
:dba_name => "Jane's Ladders",
:tax_id => "98-7654321",
:address => {
:street_address => "111 Main St",
:locality => "Chicago",
:region => "IL",
:postal_code => "60622"
}
},
:funding => {
:descriptor => "Blue Ladders",
:destination => Braintree::MerchantAccount::FundingDestination::Bank,
:email => "funding@blueladders.com",
:mobile_phone => "5555555555",
:account_number => "1123581321",
:routing_number => "071101307"
},
:tos_accepted => true,
:master_merchant_account_id => "14ladders_marketplace",
:id => "blue_ladders_store"
}
result = gateway.merchant_account.create(merchant_account_params)Parameters
:account_numberString:extended_addressString:localityString:postal_codeString:regionString:street_addressString:company_nameString:date_of_birthString:emailString:first_nameString:last_nameString:phoneString:routing_numberString:ssnString:tax_idString:addressString:localityString:postal_codeString:regionString:street_addressString:dba_nameStringThe "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.
:legal_nameStringThe 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.
:tax_idString:account_numberStringThe value representing a checking account number. Required if the request's funding destination is bank, prohibited otherwise.
:descriptorString:destinationStringThe 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 mobile_phone, are no longer supported for new merchants. Contact us with questions or concerns.
:emailStringThe 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.
:mobile_phoneStringThe 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 mobile_phone.
:routing_numberStringThe numeric value representing a specific bank. Required if funding destination is bank, prohibited otherwise.
:idStringSpecifies 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.
:addressString:localityString:postal_codeString:regionString:street_addressString:date_of_birthStringYYYYMMDD or YYYY-MM-DD.:emailString:first_nameString:last_nameString:phoneString:ssnStringSpecifies 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.
:tos_acceptedboolWhether the sub-merchant has read and agreed to the Terms of Service (TOS). See the terms of service accepted parameter for more information.