See also the MerchantAccount response object.

Ruby
Copy
Copied
result = gateway.merchant_account.update(
  "blue_ladders_store",
  :individual => {
    :first_name => "Jane"
  }
)
if result.success?
  p "Merchant account successfully updated"
else
  p result.errors
end
This code snippet now uses gateway instance methods instead of class-level methods. Learn more.

If the merchant account can't be found, it will raise a Braintree::NotFoundError.

Arguments
id required, String

The ID of the sub-merchant.

Additional Parameters
:business

Only available for Braintree Marketplace accounts. Business information associated with a sub-merchant.

:address String

Only available for Braintree Marketplace accounts. Business information associated with a sub-merchant.

:locality String

The locality/city. 255 character maximum.

:postal_code String

The postal code. Postal code must be a string of 4-9 alphanumeric characters, optionally separated by a dash or a space. Spaces, hyphens, and all other special characters are ignored.

:region String

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.

:street_address String

The street address. Street address must be less than or equal to 255 characters.

:dba_name String

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.

:legal_name String

The 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 tax_id has been provided.

:tax_id String

The 9-digit numeric value associated with the business' tax identity. Required if legal_name has been provided.

:funding

Details of where funds will be disbursed for a sub-merchant.

:account_number String

The value representing a checking account number. It is required if the request's funding destination is Bank.

:descriptor String

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.

:destination String

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 MobilePhone) are no longer supported for new merchants. Any sub-merchant that is already using a Venmo destination may continue to do so, and the funding details for those accounts can still be updated. Learn more about sub-merchant funding.

:email String

The email address composed of ASCII characters.

:mobile_phone String

The mobile phone number. Phone must be 10 - 14 characters and can only contain numbers, parentheses, and periods.

:routing_number String

The numeric value representing a specific bank. Required if funding destination is Bank.

:individual

Individual information associated with a sub-merchant.

:address String

Individual address information associated with a sub-merchant.

:locality String

The locality/city. 255 character maximum.

:postal_code String

The postal code. Postal code must be a string of 4-9 alphanumeric characters, optionally separated by a dash or a space. Spaces, hyphens, and all other special characters are ignored.

:region String

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.

:street_address String

The street address. Street address must be less than or equal to 255 characters.

:date_of_birth String

The applicant's date of birth. Values can be passed as YYYYMMDD or YYYY-MM-DD.

:email String

Email address composed of ASCII characters.

:first_name String

The first name. The first name value must be less than or equal to 255 characters.

:last_name String

The last name. The last name value must be less than or equal to 255 characters.

:phone String

Phone number. Phone must be 10-14 characters and can only contain numbers, dashes, parentheses and periods.

:ssn String

Either the full 9-digit Social Security Number or the last 4 digits. The value may be passed with or without dashes. If an SSN is not provided, we will attempt to retrieve the SSN based on other information.

See also

Still have questions?

If you can’t find an answer, contact our Support team