# Decline Message Mapping

***

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

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F0dRfDsTSy9Na2kQPlWxh%2FUntitled.png?alt=media&#x26;token=9de0f5a1-c617-4bf5-9414-457756916ca6" 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://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F8Rfoh4oBtYBqDh5uovO6%2Fimage.png?alt=media&#x26;token=29dab9b5-1877-4931-a49b-26067cc26bb0" 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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FNUKxsSKTymzzCV9omr2T%2FUntitled.png?alt=media&#x26;token=d25c7907-4c82-4967-bbe0-4b2e6aea51cc" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FcGtxUlyLeQDBSQLQ6HsP%2Fimage.png?alt=media&#x26;token=f4bbe4c5-ff7c-4743-ba69-fba0bf8d882c" alt="" width="563"><figcaption></figcaption></figure>