# Decline Message Mapping

Go to **Gateways → Decline Mapping** and Click the *Green* **+ Button**:

<figure><img src="/files/efUcfA3g6bCH6bH2n5MJ" alt=""><figcaption></figcaption></figure>

Use the Create Decline Message Map dialog to transform the Type of Decline from a Gateway. This is typically used to map Hard Declines to Soft Declines under specific conditions:

<figure><img src="/files/crATnqNSQK2BVzJxmQkp" alt="" width="290"><figcaption></figcaption></figure>

* **Gateway or Merchant**: Type of biller where the Decline Map should apply
  * Choose **Gateway** if the mapping rule should apply to an entire gateway type
  * Choose **Mid** if the mapping rule should apply to only a single gateway on your gateway list
* **Select Gateway**: Identity of gateway where the Decline Map should apply
* **Order Type**: Choose to apply this mapping to All Orders, New Sales only, or Recurring Orders only
* **Decline Message**: The Decline Message returned by the gateway/processor.  This is a contained-in search, so only a portion of the gateway/processor response must be entered.
* **Map to Decline Type**: Choose how the Decline is Mapped
  * Soft Decline
  * Hard Decline
* **Map to Decline Message**: (Optional) Change the gateway’s decline message to show as something different to your customers. This is useful if the gateway’s error message is not “customer friendly”

<figure><img src="/files/ULr4uFNWSmZUXvCiGoO0" alt=""><figcaption></figcaption></figure>

&#x20;

Once created, you can view all of your Decline Mappings:

<figure><img src="/files/5GjEIyAo5ZwpZKr3BmDJ" alt="" width="563"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.konnektive.com/konnektive-crm/gateway-setup/decline-message-mapping.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.