Merchant Account: Create
See also the Merchant Account response object.
- Python
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
'locality'str'region'str'email'str'first_name'str'last_name'str'phone'str'ssn'str'tax_id'str'address'str'locality'str'region'str'dba_name'strThe "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_name'strThe 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_id'strThe value representing a checking account number. Required if the request's funding destination is bank, prohibited otherwise.
'descriptor'strThe 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.
'email'strThe 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.
The 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.
The numeric value representing a specific bank. Required if funding destination is bank, prohibited otherwise.
'id'strSpecifies 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'str'locality'str'region'strYYYYMMDD or YYYY-MM-DD.'email'str'first_name'str'last_name'str'phone'str'ssn'strSpecifies 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_accepted'boolWhether the sub-merchant has read and agreed to the Terms of Service (TOS). See the terms of service accepted parameter for more information.
