🧪 Experimental KB — Official knowledge hub: community.kaptio.com

KaptioPay payment confirmation dialog not appearing for internal users

Customer reported that the payment confirmation dialog was not showing up after successful payments when using KaptioPay from Salesforce Core (internal users). Payments were processing successfully, b

KaptioPay Braintree payment confirmation internalOptions redirect URL Salesforce Core

Problem

Customer reported that the payment confirmation dialog was not showing up after successful payments when using KaptioPay from Salesforce Core (internal users). Payments were processing successfully, but the confirmation popup never appeared.

What We Found

The internalOptions.successRedirect field was empty in the Braintree Payment Configuration JSON for all channels in Kaptio Pay Settings. Without this redirect URL configured, KaptioPay doesn’t know where to redirect after successful payment, so the confirmation dialog never triggers.

Solution

  1. Navigate to Kaptio Pay Settings in Salesforce
  2. Select the channel that needs the fix (e.g., Direct Guest)
  3. In the Braintree Payment Configuration JSON, locate the internalOptions section
  4. Add the successRedirect field with a FULL URL (not a relative path) pointing to your payment confirmation VF page
  5. Use this format:
    "successRedirect": "https://[your-org]--c.sandbox.vf.force.com/apex/[YourVFPage]?success=true&id={itineraryId}"
  6. Save the configuration and test by making a payment from Salesforce Core

Notes

  • Internal users (Salesforce Core) require a FULL URL in internalOptions.successRedirect - relative paths will return a 404 error
  • External users (Sites/Portals) can use relative paths in externalOptions.successRedirect
  • The {itineraryId} placeholder is automatically replaced with the actual itinerary ID
  • If you have custom code handling the confirmation dialog, ensure the VF page controller is set up to handle the redirect appropriately
  • This configuration needs to be set for EACH channel that internal users will use for payments

Warnings

⚠️ Using a relative path (e.g., /apex/PageName) for internalOptions.successRedirect will result in a 404 error - always use the full URL for internal users ⚠️ After clicking OK on the confirmation dialog, the redirect behavior depends on your VF page controller - test to ensure users are redirected back to the appropriate page


Source: KHELP-12362

Was this article helpful?