Merchant Account

Merchant Account: Create

See also the Merchant Account response object.

  1. 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
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
:localityString
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
:regionString
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
:emailString
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
:phoneString
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
:ssnString
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
:tax_idString
This functionality still exists in the gateway but is no longer documented. Will remove this param/attr when the corresponding gateway code is removed.
Only available for Braintree Marketplace accounts. Business information associated with a sub-merchant.
:addressString
Only available for Braintree Marketplace accounts. Business information associated with a sub-merchant.
:localityString
The locality/city. 255 character maximum.
The postal code. Postal code must be a string of 4-9 alphanumeric characters, optionally separated by a dash or a space. Spaces and hyphens are ignored.
:regionString
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.
The street address. Street address must be less than or equal to 255 characters.
:dba_nameString

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 ("). 40 character maximum.

:tax_idString
The 9-digit numeric value associated with the business' tax identity. Required if business information has been provided.
Details of where funds will be disbursed for a sub-merchant.

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

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. 22 character maximum.

The 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.

:emailString

The 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.

:idString

Specifies 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.

Individual information associated with a sub-merchant.
:addressString
Individual address information associated with a sub-merchant.
:localityString
The locality/city. 255 character maximum.
The postal code. Postal code must be a string of 4-9 alphanumeric characters, optionally separated by a dash or a space. Spaces and hyphens are ignored.
:regionString
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.
The street address. Street address must be less than or equal to 255 characters.
The applicant's date of birth. Values can be passed as YYYYMMDD or YYYY-MM-DD.
:emailString
Email address composed of ASCII characters.
The first name. The first name value must be less than or equal to 255 characters.
The last name. The last name value must be less than or equal to 255 characters.
:phoneString
Phone number. Phone must be 10-14 characters and can only contain numbers, hyphens and parentheses.
:ssnString
The full 9-digit Social Security Number is required if the sub-merchant is not a registered business.

Specifies 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.

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