Braintree Marketplace
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.
- 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.