Skip to content

Set up NMI

Connect NMI to your Bolt merchant account.

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

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.

IP Restrictions

Step 2: Obtain NMI keys

  1. Log into your NMI merchant account.
  2. Go to My Settings > Security Keys > Add a New Private Key. Add new private key
  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

  1. Log into the Bolt Merchant Dashboard.
  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

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

For saved cards, Bolt does not transmit CVV match data. Use NMI's CVV settings to allow transactions without CVV matches.

With Fraud Protection

Use NMI's AVS settings to allow shipping and billing address mismatches.

Without Fraud Protection

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

Step 6: Set up chargeback notifications

Configure NMI communication preferences for digital chargeback notifications.

Chargeback handling

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

On this page