📍 Bolt Help / Integrations / Payment Processors / Set Up Bolt for NMI
Set Up Bolt for NMI
Learn how to integrate Bolt with NMI.

New Dashboard Notice

Bolt has launched a new Merchant Dashboard experience. See this corresponding page for help documentation that reflects the Legacy Dashboard.

Please note that Legacy Dashboard documentation may no longer have up to date information on our newest features and releases.


See Set Up Bolt One-Click for BigCommerce for instructions specific to this platform.


How to Integrate with NMI

Step 1: Add Bolt and Merchant IPs to Allowlist

If you have IP blocklists enabled, you must add the following IP addresses to your allowlist:

  • 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

Then, add your office IP addresses to the allowlist to ensure successful payment processing.

IP Restrictions

Step 2: Obtain NMI Keys

  1. Log in to your NMI merchant account.
  2. Navigate 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 in to the Bolt Merchant Dashboard in a separate tab.
  2. Navigate to Settings > Payments.
  3. Click Set Up NMI.
  4. Add your Private NMI Key.
  5. Click Next.
  6. Edit the default payment settings to customize how processing works.
  7. Click Complete Setup.

Step 4: Configure NMI Webhook

Webhooks keep your systems in sync, allowing Bolt and NMI to easily exchange data about chargebacks. Failure to set up webhooks will result in discrepancies between your systems.

  1. Log into your NMI merchant account.
  2. Navigate to Webhooks.
  3. Click Create.
  4. Find the following information from the Bolt Merchant Dashboard:
    • URL: Navigate to Settings > Payments > Manage NMI and copy the Bolt webhook URL.
    • Public ID: Navigate to Developers > Public ID. Replace <public-id> in the URL.
  5. Enable chargeback.batch.complete .
  6. Save.
  7. Copy the webhook’s signing key.
  8. Log into the Bolt Merchant Dashboard.
  9. Navigate to Settings > Payments.
  10. Click Manage NMI.
  11. Add the NMI Signing Key.

Step 5: Configure NMI Risk Settings

For payments made with a card saved to a shopper’s account, Bolt does not transmit CVV match data to processors. To configure risk settings so the lack of this data does not trigger auto-declines:

Use the NMI guide CVV Settings to allow transactions without CVV matches.

With Fraud Protection

Bolt’s fraud detection engine uses advanced risk signals to protect your business from fraud. Bolt Checkout does not require shoppers to enter a billing address, so the Address Verification System (AVS) mismatch settings may trigger automatic declines on transactions from real shoppers with an otherwise low risk score.

Use the NMI guide on AVS settings to allow all transactions where the shipping and billing address do not match.

Without Fraud Protection

Contact your fraud solutions provider to inform them that payments transmitted via this processor will not provide CVV match information.

Step 4: Set Up Chargeback Notifications

Set up your communication preferences in NMI to receive digital notifications for new chargebacks. This ensures that you have enough time to submit the dispute and respond with evidence.

Chargeback Handling

  • With Fraud Protection: NMI supports manual dispute submissions.
  • Without Fraud Protection: Follow NMI’s chargebacks handling process.
Filter by Section
Filter by Topic