> For the complete documentation index, see [llms.txt](https://help.konnektive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.konnektive.com/konnektive-crm/gateway-setup/decline-message-mapping.md).

# 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>