# Consumer Clarity
source: https://developer.mastercard.com/consumer-clarity/documentation/index.md

## Overview {#overview}

Provide your cardholders with detailed information about specific transactions in your banking app or to your call center agents with the Consumer Clarity API. The Consumer Clarity API provides these products:

<br />

* **Merchant Details**: Returns a clear merchant name and logo, the purchase location, and additional merchant details for each merchant reference included in the request.

* **Digital Receipts**: Returns an Ethoca-generated digital receipt URL when transaction references are provided in the request and the specified merchant is on the Ethoca network.

* **Carbon Footprint**: Returns a carbon score for a transaction to educate cardholders about the environmental impact of their purchases.

* **Smart Subscriptions** : (formerly **Subscription Controls**) Returns subscription information for subscription purchases and lets cardholders manage their subscriptions in a centralized manner.

  * **Subscription Identification**: Identifies which transactions are subscriptions along with their frequency and details, such as past and upcoming payments.

  * **Manage subscriptions**: Lets cardholders take actions on their subscriptions, such as canceling or changing plans directly in their banking app. In addition, merchants can present dynamic retention offers to help retain customers.

* **Call Center**: Returns real-time data about a merchant transaction involved in a customer dispute. The rich merchant and transaction information provided lets your agents make informed decisions that can eliminate costly, unnecessary chargebacks from first-party fraud and customer disputes. Call Center provides these benefits:

  * **Merchant Details**: Returns a clear merchant name, logo, the purchase location, and additional merchant details for each merchant reference included in the request.

  * **Transaction Details**: Returns details about the purchase in question including order details, any refund information associated with the transaction, and additional merchant contact information.

  * **First-Party Trust** : If a transaction is eligible for the First-Party Trust program, information is returned about the purchase in question, including applicable compelling evidence. For more information, see [First-Party Trust Program](https://developer.mastercard.com/product/first-party-trust/).

<br />

All of this works together to provide your cardholders and your staff with purchase transparency and clarity.

### Before you start {#before-you-start}

Adding each of the products mentioned above provides enhanced value to the Consumer Clarity API. In order to leverage their capabilities, you first need to integrate with the Consumer Clarity API. Check out [Next Steps](https://developer.mastercard.com/consumer-clarity/documentation/index.md#next-steps) to start integrating.
Note: You can now receive all your digital information through the Consumer Clarity API, formerly called the Enriched Transactions API.

## How It Works {#how-it-works}

When a cardholder contacts you directly, or through your banking app, the Consumer Clarity API provides the merchant and transaction data that can help them recognize a transaction. There are slight differences in the workflow for the digital channel vs. the call center channel. This section describes the workflow for each of the different channels.

### How it works in the digital channel {#how-it-works-in-the-digital-channel}

1. Within your mobile app or website, a cardholder views their transactions.

2. In real-time, [you call the Consumer Clarity API](https://developer.mastercard.com/consumer-clarity/documentation/use-cases/index.md#use-case-in-the-digital-channel) for additional details to display about those transactions.

3. Ethoca responds to the API request with relevant details such as merchant information, logos, subscription information, and full digital receipts.

4. You display these enhanced elements in your transaction views and transaction detail pages in real-time.

5. If a digital receipt is available, the cardholder can select "View Receipt" to see it.

6. If a subscription is manageable, the cardholder can submit requests directly to the merchant through the banking app, such as canceling or changing plans. Merchants can return targeted retention offers and provide real-time action status updates to help prevent cancellations and to ensure transparency as the cardholder manages the subscription.

![How the digital channel works](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/how-digital-works.png)

### How it works in the call center channel {#how-it-works-in-the-call-center-channel}

1. A cardholder contacts you to ask about a transaction they don't recognize or to file a dispute claim.

2. [You send an API POST request to the Consumer Clarity API](https://developer.mastercard.com/consumer-clarity/documentation/use-cases/index.md#use-case-in-the-call-center-channel), which requests comprehensive transaction details from the merchant.

3. Detailed merchant and purchase information is returned in real-time, either through a "call-center" url or in raw JSON format from the API.

4. If you use the url, you can select it to retrieve the information for offline review and investigation, or you can view the information and discuss it with the cardholder. If you use the API, the information is provided in the output of your organization's choice, such as imported into a data lake or data warehouse, or displayed in your own internal CRM tools.

![How the Call Center service works](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/how-call-center-works.png)

## Next Steps {#next-steps}

* Run through the [Quick Start Guide](https://developer.mastercard.com/consumer-clarity/documentation/quick-start-guide/index.md) if you'd like to quickly connect and start making calls to the Consumer Clarity API in a sandbox environment.
* Use the [API Reference](https://developer.mastercard.com/consumer-clarity/documentation/api-reference/index.md) information for details about the fields and values relevant to your specific needs.
