Jump to content

Stripe Dynamic Payments records slightly incorrect payment amounts with currency conversion


Recommended Posts

Hi everyone,

After switching from the legacy Stripe module to Stripe Dynamic Payments, we started noticing small differences between the amount customers actually pay and the payment amount recorded in WHMCS. This did not happen with the previous module.

Environment:

  • WHMCS 9.1.0

  • PHP 8.4

  • Official Stripe Dynamic Payments module

  • “Convert To For Processing” set to “None”

  • Stripe settlement currency: EUR

Here is one example:

  • Invoice total: 520.00 MXN

  • Amount successfully charged in Stripe: 520.00 MXN

  • Stripe exchange rate: 1 MXN = 0.0476752 EUR

  • Gross settlement amount in Stripe: 24.79 EUR

  • Payment amount recorded in WHMCS: 519.98 MXN

  • Transaction fee recorded in WHMCS: 32.09 MXN (1.53 EUR in Stripe)

The discrepancy can be reproduced by converting the rounded EUR settlement amount back to MXN:

24.79 / 0.0476752 = 519.976843… → 519.98 MXN

The fee calculation matches too:

1.53 / 0.0476752 = 32.092156… → 32.09 MXN

This suggests that the module may be reconstructing the payment amount from the rounded settlement amount instead of using the original amount charged in the invoice currency. However, we have not confirmed this in the module’s implementation.

In this particular example, the invoice shows as Paid with a zero balance, despite the ledger recording 519.98 MXN against a 520.00 MXN invoice. We have also noticed small outstanding balances on other payments since switching modules.

Has anyone experienced this with Stripe Dynamic Payments?

Is this a known issue, and is there a hotfix or configuration change to prevent it? When the charge currency matches the invoice currency, should WHMCS record the original gross charge amount and convert only the transaction fee?

We would prefer to keep Dynamic Payments enabled, so any guidance would be appreciated.

Link to comment
Share on other sites

  • 3 weeks later...

Hi Juanzo,

It's not just you, and it's not your setup. This is a confirmed bug. glenn hit the same thing (invoice in one currency, Stripe settling in another) and WHMCS Support confirmed it as WHMCS-26898: Dynamic Payments converts the rounded settlement amount back to the invoice currency instead of recording what was actually charged. No ETA yet. Thread: Stripe Dynamic Payments: invoices left Unpaid with 0.01 balance

Until it's fixed:

  • For the invoices left a few cents short, use Add Payment for the difference so they close and your reports stay right.
  • If Stripe lets your account settle in the same currency as the invoice (an MXN balance or bank account), no conversion happens and the bug doesn't trigger.
  • Watch the release notes and hotfixes for WHMCS-26898.

Cent over-payments just go to the client's credit balance, so only the short ones need attention.

Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

  • Recently Browsing   0 members

    • No registered users viewing this page.
×
×
  • Create New...

Important Information

By using this site, you agree to our Terms of Use & Guidelines and understand your posts will initially be pre-moderated