Skip to main content

Add a Stripe Restricted API Key to Bloomerang CRM

Updated over 2 weeks ago

Stripe requires that all organizations use restricted API keys for payment processing. This helps increase payment security and fulfill fraud prevention requirements. This article describes how to generate a restricted API key and update your Bloomerang CRM settings to meet this requirement.

Important: New Bloomerang CRM customers who onboard on or after February 10, 2026, must use Bloomerang Payments to process transactions unless your organization is located outside of the United States. Organizations outside of the United States, including Canada and other countries, must use an integrated third-party processor (Stripe or Authorize.net) to process payments in Bloomerang.

Generate a Restricted API Key in Stripe

To generate a new restricted API key in Stripe, do the following. For detailed instructions, read Using Stripe gateways with Restricted API Key authentication in the Spreedly documentation.

  1. On your Stripe dashboard, Click Developers to go to the Developers page.

  2. Click API keys to view the API keys page.

  3. In the Restricted Keys section, click +Create Restricted Key.

  4. Click Providing this key to another website.

  5. Click Continue.

  6. In the Name box, enter a name for the new API key.

  7. In the URL box, enter https://crm.bloomerang.co/.

  8. Select Customize Permissions for this key.

  9. Set the Permissions and Connect Permissions for the following resource types to Write:

    • Charges

    • Customers

    • PaymentIntents

    • PaymentMethods

    • SetupIntents

    • Tokens

  10. Set the permissions for Webhook Endpoints to Write. This Resource type does not have any Connect Permissions.

  11. Click Create Key.

  12. Click the new API key to copy it to your clipboard.

  13. Click Done.

Add the Restricted API Key in Bloomerang

  1. In Bloomerang CRM, click Payments.

  2. Click Payments Home.

  3. In the Other Processors section, click Stripe. If you have not updated your Stripe settings with a restricted API key, Stripe is listed in red text on this page.

  4. On the Transaction Processor page, click in the Restricted Key box and paste the API key that you created in the Generate a Restricted API Key in Stripe section.

  5. Click Save.

  6. On the Payments Settings page, confirm that Stripe is listed in blue text in the Other Processors section. This means that the Stripe settings have been updated to use the restricted API key.

Related

Did this answer your question?