# Set up NMI

> Connect NMI to your Bolt merchant account.

Source: https://help.boltapp.com/integrations/payment-processors/nmi

Connect NMI to Bolt so Bolt can authorize and capture payments through your NMI account.

## Step 1: Allowlist Bolt and merchant IPs [#step-1-allowlist-bolt-and-merchant-ips]

If IP blocklists are enabled, allow:

* `13.57.173.93`
* `18.236.33.230`
* `34.209.104.177`
* `52.36.152.150`
* `12.2.150.168/29`
* `12.249.26.128/30`
* `50.18.19.8`

Also add your office IP addresses.

<img alt="IP Restrictions" src="__img0" />

## Step 2: Obtain NMI keys [#step-2-obtain-nmi-keys]

1. Log into your NMI merchant account.
2. Go to **My Settings** > **Security Keys** > **Add a New Private Key**.
   <img alt="Add new private key" src="__img1" />
3. Click **generate a new API key**.
4. Click **view**.
5. Copy the 32-character API key.

## Step 3: Add keys and edit payment settings [#step-3-add-keys-and-edit-payment-settings]

1. Log into the [Bolt Merchant Dashboard](https://merchant.boltapp.com).
2. Go to **Settings** > **Payments**.
3. Click **Set Up NMI**.
4. Add your private NMI key.
5. Click **Next**.
6. Edit payment settings, then click **Complete Setup**.

**Expected result:** NMI appears as your active processor under **Settings** > **Payments**.

## Step 4: Configure NMI webhook [#step-4-configure-nmi-webhook]

Webhooks keep Bolt and NMI in sync for chargebacks.

1. Log into your NMI merchant account.
2. Go to **Webhooks** and click **Create**.
3. From the Bolt Merchant Dashboard:
   * **URL:** **Settings** > **Payments** > **Manage NMI** (copy the Bolt webhook URL)
   * **Public ID:** **Developers** > **Public ID** (replace `<public-id>` in the URL)
4. Enable **chargeback.batch.complete**.
5. Save and copy the webhook signing key.
6. In the Bolt Merchant Dashboard, go to **Settings** > **Payments** > **Manage NMI** and add the **NMI Signing Key**.

## Step 5: Configure NMI risk settings [#step-5-configure-nmi-risk-settings]

For saved cards, Bolt does not transmit CVV match data. Use NMI's [CVV settings](https://support.nmi.com/hc/en-gb/articles/360002720238-AVS-and-CVV-settings#Heading%202) to allow transactions without CVV matches.

### With Fraud Protection [#with-fraud-protection]

Use NMI's [AVS settings](https://support.nmi.com/hc/en-gb/articles/360002720238-AVS-and-CVV-settings#Heading%201) to allow shipping and billing address mismatches.

### Without Fraud Protection [#without-fraud-protection]

Tell your fraud provider that payments through this processor will not include CVV match information.

## Step 6: Set up chargeback notifications [#step-6-set-up-chargeback-notifications]

Configure NMI communication preferences for digital chargeback notifications.

## Chargeback handling [#chargeback-handling]

* **With Fraud Protection:** NMI supports manual dispute submissions.
* **Without Fraud Protection:** Follow NMI's chargebacks process.

## Related [#related]

* [Payment processors](/integrations/payment-processors)
* [Fraud Protection](/products/add-ons/fraud-protection)