Client invoice payment flow

Handle a Stripe API error during callback

Return safely to the invoice when Session or PaymentIntent retrieval fails. The guide then takes you through the correct route, the checks to complete before making changes, the workflow in order, and the evidence to review afterwards.

Audience: CRM staffPermission: Invoice recipient / configured staffModule v1.0.0
Jump to steps
Where to goStripe return → iDEAL callback → Invoice
Before you start
  • Use the exact navigation above and confirm the intended invoice, case, client, property, document or environment.
  • Verify 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 you’ll accomplish

Return safely to the invoice when Session or PaymentIntent retrieval fails. These instructions follow the supplied module’s live hooks, menus, controllers, forms, model rules and downstream effects.

Follow these steps

  1. Read the failure alert.
  2. Check Stripe API availability and keys.
  3. Verify the transaction in Stripe before retrying to avoid duplicate customer action.

Fields and options to review

Caught exceptionStripe ApiErrorException
Category/help-centre/category/stripe-ideal-payment-gateway/
Topic/help-centre/topic/stripe-ideal-client-payment-flow/

Rules the system enforces

  • The flow follows the supplied controller and Stripe Session configuration.

How to confirm it worked

  • Handle a Stripe API error during callback 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 least-privilege account that has the stated permission.
  • Use a controlled test record before applying provider, financial, public-link, email or destructive actions in production.