When connecting Zengine to Stripe for program or award payments, communication flows two ways:
1. Zengine to Stripe: Controlled by the Stripe Secret Key entered in your workspace plugin. 2. Stripe to Zengine: Controlled via a Webhook on the Stripe side, which alerts Zengine when a payment event has successfully occurred.
This article clarifies how these webhooks are managed and how you can seamlessly migrate a workspace to a different Stripe account without disrupting active payment flows.
How Webhooks are Created (Automated Process)
You do not need to manually configure webhooks within your Stripe dashboard when setting up a new program.
Dynamic Creation: Zengine automatically handles webhook creation via the Stripe API the very first time a charge event is initiated in that workspace.
The Bridge: It uses the active Stripe Secret Key provided in your plugin to dynamically establish that specific communication bridge back to your workspace. Each workspace securely establishes and manages its own unique webhook.
How to Switch Stripe Accounts or Update API Keys
If a workspace was accidentally connected to the wrong Stripe account, or if you simply need to update your keys for a new cycle, follow these steps:
Step 1: Update the Secret Key in Zengine
1. Connect to the relevant Zengine workspace.
2. Click Settings and Tools in the top right-hand corner.
3. Open the Stripe Integration Plugin settings
4. Click on the active integration.
5. Navigate to the Plugin Settings tab.
6. Replace the existing key in the Stripe Secret Key field with your new Stripe account's API key.
7. Click the Save configuration button in the lower right-hand corner.
Zengine will immediately begin authenticating all outbound charge requests against this new account.
Step 2: Establish the New Webhook
You do not need a developer to manually copy or program a new webhook into your new Stripe dashboard.
Once the new API key is saved, the next time a charge event occurs, Zengine will automatically trigger the Stripe API to generate and update the necessary webhook inside the new Stripe account.
⚠️ Important Note on Timing: To avoid any minor payment interruptions, it is highly recommended to update the key during a window of low user activity, or before a program officially goes live to applicants.