# Ethoca Refunds

***

**Ethoca** is a global collaboration platform, acquired by Mastercard in 2019, that enables real-time data sharing between merchants and card issuers to facilitate faster transaction dispute resolution and reduce chargebacks

***

{% hint style="info" %}
You might be interested in our [Ethoca plugin](https://help.checkoutchamp.com/crm/plugins/chargeback-management/ethoca)
{% endhint %}

## Add Ethoca as a Refund Reason <a href="#rdr-addrdrasarefundreason" id="rdr-addrdrasarefundreason"></a>

Go to **CRM → Call Centers** and scroll down to the Refund Reasons panel.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F7rHFFUBzD4tlpOy42Ys1%2Fimage.png?alt=media&#x26;token=c0cfdd57-6acc-4908-b2e6-39ea17f52375" alt=""><figcaption></figcaption></figure>

Press the green + button on the far right and add **Ethoca** as a reason.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F46aJ1kBmIqKHUFsDnoxa%2Fimage.png?alt=media&#x26;token=5f6acff4-6aa7-4f18-9b67-255d12c3b0c6" alt="" width="375"><figcaption></figcaption></figure>

***

## Add Ethoca Fees into Gateway configuration <a href="#rdr-addrdrfeesintogatewayconfiguration" id="rdr-addrdrfeesintogatewayconfiguration"></a>

Go to **Gateways → Gateway List** and edit your gateways to add the **Ethoca Fee**.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FPJDQwShFIE4BMyDtImnT%2Fhttps___files.gitbook.com_v0_b_gitbook-x-prod.appspot.com_o_spaces_2FiAC0G99SjXjSv2GM5PAE_2Fuploads_2Fp5YE78CvWFb1OZ6kQrzK_2Fimage.png?alt=media&#x26;token=28cf1454-6b08-4a93-a4b3-b4b700f97de7" alt=""><figcaption></figcaption></figure>

***

## Mark transactions as Ethoca <a href="#rdr-marktransactionsasrdr" id="rdr-marktransactionsasrdr"></a>

You can mark the transaction as having been refunded via Ethoca either manually in the CRM or via the Refund Transaction API.

***

### Refund Ethoca manually <a href="#rdr-settherdrmanually" id="rdr-settherdrmanually"></a>

1. Find the customer in CRM using the [Customer Service Search](https://help.checkoutchamp.com/crm/customer-section/customer-service).

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2Fd5AH6g3baFcjPiuoRi29%2Fimage.png?alt=media&#x26;token=3af68f40-c391-4b62-b427-6336389d9bcf" alt=""><figcaption></figcaption></figure>

2. Find the transaction which to refund.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FmmkJ5JM65T5TedFij0Vh%2Fimage.png?alt=media&#x26;token=85c9bb9d-b0f6-4f61-ac84-fd5d6bd5f75e" alt=""><figcaption></figcaption></figure>

3. On the transaction **Actions**, choose **Refund.**

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FxfZjdDPY0TdKJFr7dRwc%2Fimage.png?alt=media&#x26;token=fc39c0a5-911f-4aea-8699-8205a058783a" alt=""><figcaption></figcaption></figure>

4. Choose **Ethoca** for the **Refund Reason**.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FXGKMeDQee1aplDAWUOn8%2Fhttps___files.gitbook.com_v0_b_gitbook-x-prod.appspot.com_o_spaces_2FiAC0G99SjXjSv2GM5PAE_2Fuploads_2FwZfSGgowiIuqoARXxuWt_2Fimage.avif?alt=media&#x26;token=217d0a4b-79ae-4ce8-9bdb-0bf2f162fa3b" alt=""><figcaption></figcaption></figure>

5. Optionally choose to the Refunded Externally box
   1. If the refund has already been given at the gateway, check the **Refunded Externally?** box and fill in the **Refund Transaction Id** (from your gateway) if known.
   2. If the refund has not already been given, then leave **Refunded Externally?** unchecked.  The refund will be sent to the gateway.
6. Press **Refund** button

***

### Refund Ethoca via API <a href="#rdr-settherdrviaapi" id="rdr-settherdrviaapi"></a>

1. Review the **Refund Transaction API** [here](https://apidocs.checkoutchamp.com/#9a74cdd2-0b0d-4894-89df-772ecc85d252)
2. Create an API user with access to the **Refund Transactions** endpoint. Be sure to whitelist as needed.
3. Call the **Refund Transactions API** with
   1. **transactionId**
   2. `refundReason=Ethoca`
   3. `externalRefund=1`  (if refund has already been given at the gateway)
   4. `fullRefund=1`
   5. **loginId** = API user username
   6. **password** = API user password

***

## Reporting <a href="#rdr-reporting" id="rdr-reporting"></a>

### Refund Details Report

If the steps above are followed properly, the [Refund Details Report](https://help.checkoutchamp.com/crm/reports/payment-reports/refund-details) will display the Ethoca transactions. Some transactions will be displayed as **External** (Externally Refunded).

You will see **Ethoca** in the **Refund Reason** column.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FF9ScmRI11KcOQARlYhjK%2Fimage.png?alt=media&#x26;token=59d372a6-9767-42cc-be34-c562e4ca561a" alt="" width="563"><figcaption></figcaption></figure>

### Transaction Summary Report

Additionally, the **Ethoca Fee** is calculated as an expense on your [Transaction Summary Report](https://help.checkoutchamp.com/crm/reports/payment-reports/transaction-summary-report).

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FMqdWpAFKBepWZa4ESQjU%2Fhttps___files.gitbook.com_v0_b_gitbook-x-prod.appspot.com_o_spaces_2FiAC0G99SjXjSv2GM5PAE_2Fuploads_2Fze8puMkZ3wR76JvslW6c_2Fimage.avif?alt=media&#x26;token=ebf1f58c-741c-4401-89b7-82018db919a0" alt=""><figcaption></figcaption></figure>

Hover over the Expenses value to see the breakdown.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FRvgrLYSAgomzY1FhSK7w%2Fhttps___files.gitbook.com_v0_b_gitbook-x-prod.appspot.com_o_spaces_2FiAC0G99SjXjSv2GM5PAE_2Fuploads_2FEoQnXKpzJQNzBXrIE0cd_2Fimage.png?alt=media&#x26;token=b65c53bd-07ef-472b-8c7b-bf315c475110" alt=""><figcaption></figcaption></figure>
