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. Node
const merchantAccountParams = {
    individual: {
        firstName: "Jane"
    }
};
gateway.merchantAccount.update("blue_ladder_store", merchantAccountParams, (err, result) => {
    result.success; // true
});
If the merchant account can't be found, it will return a [`notFoundError`](/braintree/docs/reference/general/exceptions/node#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. node
var merchantAccountParams = {
    individual: {
        firstName: "Jane",
        lastName: "Doe",
        email: "[email protected]",
        phone: "5553334444",
        dateOfBirth: "1981-11-19",
        ssn: "456-45-4567",
        address: {
            streetAddress: "111 Main St",
            locality: "Chicago",
            region: "IL",
            postalCode: "60622"
        }
    }
};
gateway.merchantAccount.update("blue_ladder_store", merchantAccountParams, function (err, result) {
    result.merchantAccount.individual.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. Node
var merchantAccountParams = {
    business: {
        legalName: "Jane's Ladders",
        dbaName: "Jane's Ladders",
        taxId: "98-7654321",
        address: {
            streetAddress: "111 Main St",
            locality: "Chicago",
            region: "IL",
            postalCode: "60622"
        }
    }
};
gateway.merchantAccount.update("blue_ladder_store", merchantAccountParams, function (err, result) {
    result.merchantAccount.business.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. Node
var merchantAccountParams = {
    funding: {
        descriptor: "Blue Ladders",
        destination: braintree.MerchantAccount.FundingDestination.Bank,
        email: "[email protected]",
        mobilePhone: "5555555555",
        accountNumber: "1123581321",
        routingNumber: "071101307"
    }
};
gateway.merchantAccount.update("blue_ladder_store", merchantAccountParams, function (err, result) {
    result.merchantAccount.funding.routingNumber; // 071101307
});
Only the last 4 digits of the account number will be returned after a successful update since the field contains sensitive data.