Additional Features/
Braintree Marketplace/
Updating Sub-merchants

Updating Sub-merchants

To update a sub-merchant, you must specify the merchant_account_id along with the attributes to be changed. Any attributes not passed in the update call will remain unchanged.
  1. 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`](/braintree/docs/reference/general/exceptions/dotnet#not-found-error). You can update the sub-merchant details that fall under these 3 attributes:
  • individual
  • business
  • funding

Individual detailsAnchorIcon

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:
  1. C#
MerchantAccountRequest request = new MerchantAccountRequest {
    Individual = new IndividualRequest {
        FirstName = "Jane",
        LastName = "Doe",
        Email = "[email protected]",
        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 detailsAnchorIcon

If the sub-merchant is a registered business, you can update the DBA name, legal name, tax ID, and address fields.
  1. 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 detailsAnchorIcon

The funding section controls where Braintree will disburse the settled funds. The fields can be updated as follows:
  1. C#
MerchantAccountRequest request = new MerchantAccountRequest {
    Funding = new FundingRequest {
        Descriptor = "Blue Ladders",
        Destination = FundingDestination.BANK,
        Email = "[email protected]",
        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.