availability

If you're a new merchant looking for a marketplace solution, contact our Sales team.

To update a sub-merchant, you must specify the MerchantAccountId along with the attributes to be changed. Any attributes not passed in the update call will remain unchanged.

C♯
MerchantAccountRequest request = new MerchantAccountRequest
{
  Individual = new IndividualRequest
  {
    FirstName = "Joe",
  },
};

Result<MerchantAccount> result = gateway.MerchantAccount.Update("blue_ladders_store", request);
result.IsSuccess();
// true

If the merchant account can't be found, it will throw a NotFoundException.

You can update the sub-merchant details that fall under these 3 attributes:

  • individual
  • business
  • funding

Individual details

Every sub-merchant must have an individual tied to that account. To update or replace the individual information, pass in the details via a merchant account update call as follows:

C♯
MerchantAccountRequest request = new MerchantAccountRequest
{
  Individual = new IndividualRequest
  {
    FirstName = "Jane",
    LastName = "Doe",
    Email = "jane@14ladders.com",
    Phone = "5553334444",
    DateOfBirth = "1981-11-19",
    Ssn = "456-45-4567",
    Address = new AddressRequest
    {
      StreetAddress = "111 Main St",
      Locality = "Chicago",
      Region = "IL",
      PostalCode = "60622"
    }
  },
};

Result<MerchantAccount> result = gateway.MerchantAccount.Update("blue_ladders_store", request);
MerchantAccount merchantAccount = result.Target;
merchantAccount.IndividualDetails.FirstName;
// Jane

Only the last 4 digits of the SSN will be returned after a successful update since the field contains sensitive data.

Business details

If the sub-merchant is a registered business, you can update the DBA name, legal name, tax ID, and address fields.

C♯
MerchantAccountRequest request = new MerchantAccountRequest
{
  Business = new BusinessRequest
  {
    LegalName = "Jane's Ladders",
    DbaName = "Jane's Ladders",
    TaxId = "98-7654321",
    Address = new AddressRequest
    {
      StreetAddress = "111 Main St",
      Locality = "Chicago",
      Region = "IL",
      PostalCode = "60622"
    }
  },
};

Result<MerchantAccount> result = gateway.MerchantAccount.Update("blue_ladders_store", request);
MerchantAccount merchantAccount = result.Target;
merchantAccount.BusinessDetails.LegalName;
// Jane's Ladders

Note that the business details are optional and are in addition to the individual details that are always required. See Onboarding Sub-merchants for more information.

Funding details

The funding section controls where Braintree will disburse the settled funds. The fields can be updated as follows:

C♯
MerchantAccountRequest request = new MerchantAccountRequest
{
  Funding = new FundingRequest
  {
    Descriptor = "Blue Ladders",
    Destination = FundingDestination.BANK,
    Email = "funding@blueladders.com",
    MobilePhone = "5555555555",
    AccountNumber = "1123581321",
    RoutingNumber = "071101307"
  },
};

Result<MerchantAccount> result = gateway.MerchantAccount.Update("blue_ladders_store", request);
MerchantAccount merchantAccount = result.Target;
merchantAccount.FundingDetails.RoutingNumber;
// 071101307

Only the last 4 digits of the account number will be returned after a successful update since the field contains sensitive data.

See also