Stripe webhook management

Troubleshoot a webhook API-key warning

Correct a publishable-key/secret-key mismatch or invalid secret.

Audience: CRM staffPermission: Administrator / settings accessModule v1.0.0
Exact navigationAdmin Area → Setup → Settings → Payment Gateways → Stripe iDEAL V2
Before you begin
  • Use the exact navigation above and confirm the intended invoice, case, client, property, document or environment.
  • Confirm module activation and the stated permission before attempting the action.
  • Use a controlled test record for payments, emails, public/portal access, provider calls and deletion.

What this guide covers

Correct a publishable-key/secret-key mismatch or invalid secret. These instructions follow the supplied module’s live hooks, menus, controllers, forms, model rules and downstream effects.

Exact step-by-step process

  1. Read the exact Stripe exception shown in the warning.
  2. Confirm the secret-key field contains a secret key, not the publishable key.
  3. Save matching environment keys and reload.

Fields, choices and supported possibilities

Typical causeStripe API rejects the configured key
Category/help-centre/category/stripe-ideal-payment-gateway/
Topic/help-centre/topic/stripe-ideal-webhook-management/

Code-backed validations and workflow rules

  • The webhook check catches the API exception and prints its message in a warning.

Expected result and verification

  • Troubleshoot a webhook API-key warning completes through the supplied module flow.
  • Reopen the source record or settings page and verify the stored value, status, payment, file, timeline entry or notification.

Security, privacy and operational checks

  • Use the correct Stripe test/live account and protect signing credentials.
  • Do not call webhook-management routes from an untrusted session.