Merchant Account
Merchant Account: Create
See also the Merchant Account response object.
- Callback
- Promise
const 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.FundingDestination.Bank,
email: "funding@blueladders.com",
mobilePhone: "5555555555",
accountNumber: "1123581321",
routingNumber: "071101307"
},
tosAccepted: true,
masterMerchantAccountId: "14ladders_marketplace",
id: "blue_ladders_store"
};
gateway.merchantAccount.create(merchantAccountParams, (err, result) => { });Parameters
accountNumberStringextendedAddressStringlocalityStringpostalCodeStringregionStringstreetAddressStringcompanyNameStringdateOfBirthStringemailStringfirstNameStringlastNameStringphoneStringroutingNumberStringssnStringtaxIdStringaddressStringlocalityStringpostalCodeStringregionStringstreetAddressStringdbaNameStringThe "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.
legalNameStringThe 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.
taxIdStringaccountNumberStringThe value representing a checking account number. Required if the request's funding destination is bank, prohibited otherwise.
descriptorStringdestinationStringThe 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.
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.
mobilePhoneStringThe 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.
routingNumberStringThe 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.
addressStringlocalityStringpostalCodeStringregionStringstreetAddressStringdateOfBirthStringYYYYMMDD or YYYY-MM-DD.emailStringfirstNameStringlastNameStringphoneStringssnStringmasterMerchantAccountIdStringSpecifies 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.
tosAcceptedboolWhether the sub-merchant has read and agreed to the Terms of Service (TOS). See the terms of service accepted parameter for more information.
