# Maintain Brand Information for Consumer Clarity
source: https://developer.mastercard.com/merchant-self-services/documentation/tutorials-and-guides/maintain-consumer-clarity-brand-information/index.md

## Overview {#overview}

Use this guide if you are a multi-brand retailer or merchant partner and you
open a store, launch a brand, or change your contact details. Consumer Clarity
for Merchants shows your merchant name, logo, and contact details to issuers
and cardholders. Keeping them current helps cardholders recognize purchases,
which reduces disputes from unrecognized charges.

The Merchant Self Services API supplies these merchant details. The issuer
shows them to the cardholder through its banking app or call center.

## Prerequisites {#prerequisites}

* A Mastercard Developers project with Sandbox credentials. See the [Quick Start Guide](https://developer.mastercard.com/merchant-self-services/documentation/tutorials-and-guides/quick-start-guide/index.md).
* An OAuth 1.0a signing setup. See [API Basics](https://developer.mastercard.com/merchant-self-services/documentation/api-basics/index.md).
* The values for the `User-Id`, `Submitter-First-Name`, and `Submitter-Last-Name` headers required by every request.
* The `guid` of the submerchant you are updating. If the brand is new, create it first as described in [Onboard a submerchant](https://developer.mastercard.com/merchant-self-services/documentation/use-cases/clarity-use-cases/index.md#onboard-a-submerchant).

## Add a New Store Location {#add-a-new-store-location}

1. Send a request to the **addLocations** operation with the new location. Location fields include the address, `website`, `email`, `phone`, `refundPolicy`, `customerServiceInstructions`, `displayAddressToCardHolder`, and `displayPhoneToCardHolder`.
2. Save the `locationId` from the response.
3. Send a request to the **addCardAcceptorNames** operation for that location with the names that appear on cardholder statements.
4. Check the response. A name with a status of `FAILED` is already associated with another merchant. Choose a more specific name and resend it.

See [Add locations to an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/use-cases/clarity-use-cases/index.md#add-locations-to-an-existing-submerchant)
and [Add card acceptor names](https://developer.mastercard.com/merchant-self-services/documentation/use-cases/clarity-use-cases/index.md#add-card-acceptor-names-to-an-existing-submerchant-default-location).

## Update an Existing Location {#update-an-existing-location}

1. Send a request to the **getLocationById** operation. Save the `Etag` response header.
2. Send a request to the **updateLocation** operation with the changed fields. Set the `If-Match` header to the `Etag` value from step 1.
3. Send a request to the **getLocationById** operation again and confirm that the response shows your changes.

See [Update a location of an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/use-cases/clarity-use-cases/index.md#update-a-location-of-an-existing-submerchant).

## Add or Replace a Brand Logo {#add-or-replace-a-brand-logo}

1. Convert a JPG or PNG image to a Base64 string.
2. Send it in the required `imageBase64Encoded` field:
   * To add a logo, use the **createMerchantLogo** operation.
   * To replace a logo, use the **updateMerchantLogoByGuid** operation.
3. Send a request to the **getLogoByMerchantGuid** operation to confirm the stored logo.

```json
{
  "imageBase64Encoded": "<Base64-encoded JPG or PNG>"
}
```

See [Add a logo to an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/use-cases/clarity-use-cases/index.md#add-a-logo-to-an-existing-submerchant)
and [Update a logo of an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/use-cases/clarity-use-cases/index.md#update-a-logo-of-an-existing-submerchant).

## Retire a Location or Brand {#retire-a-location-or-brand}

* To remove a location, use the **deleteLocation** operation.
* To deactivate or reactivate a submerchant, use the **changeSubMerchantState** operation.

## Next Steps {#next-steps}

* Run the [Clarity Test Cases](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md) in Sandbox.
* Review [Matching Logic Recommendations](https://developer.mastercard.com/merchant-self-services/documentation/api-basics/index.md#matching-logic-recommendations) before you choose card acceptor names.
* See the [API Reference](https://developer.mastercard.com/merchant-self-services/documentation/api-reference/index.md) for every field and response.