# Decline Message Mapping

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

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FvzjDBTxPOYlO862o5N22%2Fimage.png?alt=media&#x26;token=3943d383-dddb-4dc9-af20-41404ba803dd" 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="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FQ9vqMnot4l4grnZZO8eo%2Fimage.png?alt=media&#x26;token=00949d84-c615-4bd2-9e15-c09e9eddb91f" 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="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FFztksZqycpgPR8nkxrfm%2Fimage.png?alt=media&#x26;token=6254fc82-6925-4a2c-a051-713ab864cd0d" alt=""><figcaption></figcaption></figure>

&#x20;

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

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FIkli5cFB8uXigU4rB7KB%2Fimage.png?alt=media&#x26;token=0fa56225-4281-4777-a177-eec8f7457bce" alt="" width="563"><figcaption></figcaption></figure>