# Ethoca Refunds

***

**Mastercard Ethoca Dispute Resolution (Ethoca)** involves refunding a consumer prior to chargeback.

{% hint style="warning" %}
The refund occurs outside of Konnektive.
{% endhint %}

{% hint style="info" %}
The refund will not be sent to the gateway if these instructions are followed.

This is the desired result.

Most gateways will accept the refund even though Ethoca has already given a refund.

It is imperative that users be properly trained on Ethoca procedures to prevent this.
{% 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://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FrgwMd40tLFyG2DK9qWNQ%2Fimage.png?alt=media&#x26;token=b5ba71d1-9009-46e3-a351-66e037bf266b" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FOHbAYTuOFzQECDtS3pAl%2Fimage.png?alt=media&#x26;token=a7b5e092-c9da-41eb-be5d-8e7bb3e06e1f" alt=""><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://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2Fp5YE78CvWFb1OZ6kQrzK%2Fimage.png?alt=media&#x26;token=f0447735-6c9a-47f3-b69e-cc52ebbfa9d9" 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.

***

### Set Ethoca refund reason manually <a href="#rdr-settherdrmanually" id="rdr-settherdrmanually"></a>

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

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FXgCyWKFGimvxr8Fmk8DO%2Fimage.png?alt=media&#x26;token=31aa658c-1de3-4d6f-92f7-a504ab1bb548" alt=""><figcaption></figcaption></figure>

2. Find the transaction which to refund.

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FMdWZOmrBqCMlVkwsNqwz%2Fimage.png?alt=media&#x26;token=24acf722-b014-438e-ac7d-5200bd682a8a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FqdHmHMd2KkUzdMjiQKBv%2Fimage.png?alt=media&#x26;token=c3e47dca-0166-4d50-a8bf-8d3d2eed00de" alt=""><figcaption></figcaption></figure>

4. Choose **Ethoca** for the **Refund Reason**.&#x20;

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FwZfSGgowiIuqoARXxuWt%2Fimage.png?alt=media&#x26;token=645ac524-9f8d-4253-b8af-1f24572bcba6" alt=""><figcaption></figcaption></figure>

5. Check the **Refunded Externally?** box and fill in the **Refund Transaction Id** (from your gateway) if known.
6. Press **Refund** button

***

### Set Ethoca refund reason 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`
   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](#refund-details-report) will display the Ethoca transactions. These transactions will be displayed as **External** (Externally Refunded).

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

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FbwsKnzW4Za4UK1VPsqmt%2Fimage.png?alt=media&#x26;token=896a4d66-95d0-4159-a5f7-9872a1e5cc0f" alt=""><figcaption></figcaption></figure>

### Transaction Summary Report

Additionally, the **Ethoca Fee** is calculated as an expense on your [Transaction Summary Report](#transaction-summary-report).

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2Fze8puMkZ3wR76JvslW6c%2Fimage.png?alt=media&#x26;token=4754b40c-0ec8-480d-ab73-47a4ebb38b95" alt=""><figcaption></figcaption></figure>

Hover over the Expenses value to see the breakdown.

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FEoQnXKpzJQNzBXrIE0cd%2Fimage.png?alt=media&#x26;token=6fecb2e0-306b-4a8d-b0c0-d29b03f2969f" alt=""><figcaption></figcaption></figure>
