Elavon Converge Hosted Payment Page Gateway - Seeking Help on Return Path

I am not a developer — I’m a lawyer running a small law firm website, www.lvtrafficticketguy.com (13K registered users). I’ve been trying to build a custom Elavon Converge Hosted Payment Page gateway for CBSubs because Elavon is one of the largest U.S. processors and works well for professional service payments.Current Status:

• Token request + redirect to Elavon Hosted Page works
• Payments are successfully approved on Elavon (ssl_result=0)
• Return URL comes back with all the correct parameters

Main Problem: After the user completes payment on Elavon and is redirected back, CBSubs is not updating the payment basket to "Completed" status. The return appears to be hitting a generic page instead of properly routing to handleReturn().System Information

• Joomla: 5.4.4
• Community Builder: 2.11.0+build.2026.03.09.15.07.44.b34f2745a
• CBSubs: 4.9.0+build.2026.02.18.17.10.13.c24dcd46a
• PHP Version: 8.3.31

I’ve modeled the code after the official eWay gateway as closely as possible (using cbsubsGatewayUrl, pspRedirectUrl, handleOtherResult, etc.).
I suspect the issue is in how the return URL is being generated or handled on the way back from Elavon.I’m happy to share the full plugin file. I’m also willing to pay for help to get this finished properly, and once done, I’d be glad to donate it to the community.Any guidance on the correct return URL handling for this type of gateway would be greatly appreciated.Thank you!

Your return redirect should be to the URL provided by the below.



Typically that's sent to the payment provider as part of the form data supplied in _getBasicRequstParams. When they're returned to the site you need to handle the return in handleReturn and typically process the data in _returnParamsHandler. The updatePaymentStatus call in _returnParamsHandler is where the payment status would be changed based off the data handled. My guess is that's where your issue might be is somewhere in your _returnParamsHandler implementation.

I've never heard of Elavon. They've the same online transaction rates as Stripe (2.90% + 30¢). Is there a particular reason you're using them over Stripe?

Hi Kyle,Thanks for the suggestion — I really appreciate you looking into this and offering your thoughts. It was genuinely helpful.You're right that the Elavon rates aren't necessarily better than Stripe’s. Looking at their MOTO/Internet pricing, the best tier (Qualified/Rewards) is 1.90% + $0.25, but it tiers up from there (Commercial at 2.65%, Non-Qualified at 3.35%, etc.). So it’s not a clear win on price alone.The main reasons I’m going with Elavon are two-fold:

1. Fee passthrough — They automatically calculate and pass the processing fees directly to the client/user, which works better for our flow.
2. Banking/compliance structure — Elavon allows us to split the deposits and withdrawals. We can have funds deposited into our trust account, while monthly fees and other charges are withdrawn from our operating account. We can even route chargebacks to a separate account if needed. This setup is important for our compliance requirements.

I’ve used Stripe for years and love the product, but this split-account flexibility is a big deal for us right now.We’re still actively working on getting everything set up and optimized with Elavon. Appreciate you looking out!Best,

Fee passthrough — They automatically calculate and pass the processing fees directly to the client/user, which works better for our flow.

Stripe lets you configure a surcharge to do the same.

Banking/compliance structure — Elavon allows us to split the deposits and withdrawals. We can have funds deposited into our trust account, while monthly fees and other charges are withdrawn from our operating account. We can even route chargebacks to a separate account if needed. This setup is important for our compliance requirements.

That's supported using Stripe Connect. That's basically its entire purpose.

At any rate please let me know if you've any further CBSubs API questions and will be glad to be of help.