Donor Fuse can connect directly to your Stripe account using a Stripe restricted API key. This method lets Donor Fuse process payments through your Stripe account without going through the Stripe Connect authorization flow. Follow the three steps below to create the key in Stripe with the correct permissions and add it to Donor Fuse.

Step 1: Create a Restricted API Key in Stripe

1. Log in to your Stripe account at dashboard.stripe.com.
2. Click the Settings icon (the gear in the top navigation).
3. Click Developers.
4. Click Manage API Keys.
5. Click Create restricted key.

On the next screen:

6. Select "Providing this key to a third-party application."
7. Click Continue.

On the next screen:

8. In the Name field, enter Donor Fuse.
9. In the URL field, enter https://www.donorfuse.com.
10. Very important: check the box "Customize permissions for this key."
11. Click Continue.

On the next screen (Permissions):

12. Make sure the following permissions are set. Most are set by default — the items marked below are not set by default and must be added manually:

Core

• Balance Transaction Sources — Read
• Charges and Refunds — Write
• Customers — Write
• Payment Intents — Write
• Payment Methods — Write
• Payouts — Read (not set by default — set this manually)
• Setup Intents — Write

Billing

• Subscriptions — Write

Financial Connections (not set by default — set these manually)

• Financial Connections Sessions — Write
• Financial Connections Accounts (List) — Read
• Financial Connections Accounts (Retrieve) — Read

13. Click Create key.
14. Copy the restricted key that appears. You'll also need your Publishable key, which is listed on the same API keys page (it begins with pk_live_...).

Important: Stripe only displays the restricted key once. Copy it immediately and store it somewhere secure. Treat this key like a password. If you lose it, you can create a new one and revoke the old key.

Step 2: Add Stripe as a Gateway in Donor Fuse

1. In Donor Fuse, go to Settings > Gateway Accounts.
2. Select Add New Gateway Account.
3. For the gateway type, select Stripe API.
4. Enter an Internal Name (required) — this is how the gateway will appear inside Donor Fuse.
5. Paste your newly created restricted API key into the API Key field.
6. Paste your Publishable key into the Publishable Key field.
7. Select "ACH Enabled" if you want this gateway to process ACH transactions.
8. Configure any remaining optional settings as needed:
   • Processing fee category
   • Multi-currency settings (statement currency and accepted processing currencies)
   • Any other specialized fields for your setup
9. Click Save. Your Stripe gateway account is now active.

Step 3: Test Your Integration

1. Enter a small test transaction in Donor Fuse to confirm the connection is working.
2. Check the transaction status in both Donor Fuse and your Stripe dashboard.

Troubleshooting:

• If you encounter any error while testing or processing a payment using this gateway, check the error message:
  • If the error message starts with Processing Error: {error message}, this means the error is from Stripe. Please contact Stripe support directly.
  • If the error message does not start with Processing Error:, contact Donor Fuse support.
• You can always reach out to Donor Fuse support to help verify the issue if you are unsure.

Need Help?

If you need assistance connecting Stripe to Donor Fuse, contact Stripe support or the Donor Fuse support team.