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

# Decline Message Mapping

***

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

<figure><img src="/files/AyTp76GFjCpFPUJDNOaf" 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/hCpVKDlftCapWGi4qfdG" alt="" width="435"><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 if this mapping applies 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/qN0mmtrXvdZAyOSiiXCo" alt=""><figcaption></figcaption></figure>

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

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