Eezz FX Payout Estimator for WooCommerce

Eezz FX Payout Estimator for WooCommerce is an admin-only WooCommerce tool for cross-border store owners who want a clearer estimate of how much money may remain after payment processing fees, withdrawal fees and exchange-rate spread.

Many WooCommerce stores sell in one currency but review their final payout in another currency. For example, a store may price products in USD, JPY or EUR, while the business owner wants to estimate the final amount in CNY or another target currency. Eezz FX Payout Estimator for WooCommerce helps administrators compare the live exchange rate, estimated net rate, payment profile fees and expected target-currency payout.

The plugin is designed for store administration and decision support. It does not change checkout prices, product prices, order totals, payment gateway behavior, tax calculations or frontend currency display.

Rates are downloaded from the configured rate service by WP-Cron and stored locally. Product helpers, order estimates, dashboard reports and exchange-rate charts use cached local data so the plugin does not need to request remote rate data on every admin page load.

This plugin provides estimates only. It does not provide financial, accounting, tax, legal or currency exchange advice. Actual payouts may differ because payment providers, banks and exchange services may use their own fees, rates, timing rules and settlement policies.

External services

This plugin downloads exchange-rate data from the following remote services:

1. Exchange-rate bundle service.

   • Service URL: configurable via the Rate Service setting (default: https://api.840156.xyz/)
   • What is sent: The plugin makes an HTTP GET request from the WordPress site server to download a public rate bundle file (bundle/flcw-rates-v1.json). No order, product, customer, administrator, or payment data is sent by the plugin. As with any HTTP request, the remote service may receive technical request metadata such as the site server IP address, request time, requested URL, and User-Agent string.
   • Terms of service: https://eezz.net/terms-of-service/
   • Privacy policy: https://eezz.net/privacy-policy/

2. USD/CNY exchange-rate chart service.

   • Service URL: https://rmb.840156.xyz/
   • Endpoints used: /api/v1/flcw/usd-cny.json, /rates/usd-cny.json, /api/v1/usdcny/history.json, /api/v1/usdcny/dashboard.json
   • What is sent: The plugin makes HTTP GET requests from the WordPress site server to download public USD/CNY exchange-rate data. No order, product, customer, administrator, or payment data is sent by the plugin. As with any HTTP request, the remote service may receive technical request metadata such as the site server IP address, request time, requested URL, and User-Agent string.
   • Terms of service: https://eezz.net/terms-of-service/
   • Privacy policy: https://eezz.net/privacy-policy/

Data from these services is cached locally in the WordPress database. The plugin does not communicate with any other remote services by default.

If an administrator changes the Rate Service base URL, the WordPress site will request exchange-rate data from the configured service chosen by that administrator.

Third-party libraries

This plugin includes Chart.js 4.5.1 for rendering admin exchange-rate charts.

Chart.js is distributed under the MIT License.
Project website: https://www.chartjs.org/
Source code: https://github.com/chartjs/Chart.js

Main Features

• Configure a rate service base domain and refresh exchange-rate data from the WordPress admin.
• Select a Calculation Currency for store prices, order amounts and fixed fees.
• Select a Target Currency for payout estimates, reverse pricing and dashboard reports.
• Store the rate bundle locally and refresh it by WP-Cron or manual refresh.
• Validate the rate bundle before it is used by product, order and dashboard estimates.
• Create editable payment profiles for PayPal, Stripe, Wise, bank transfer or custom payout methods.
• Set one default payment profile for estimates.
• Estimate product and variation payouts directly inside WooCommerce product editing screens.
• Use reverse pricing helpers to estimate the store price required for a target-currency payout amount.
• Show order payout estimates in the WooCommerce order edit screen using the current cached rates.
• Display dashboard summaries for recent sales, estimated payout and estimated FX/payment loss.
• Show a global admin bar summary for Live Rate and Net Rate for authorized administrators.
• Display live-rate and estimated net-rate loss information on the Rate Service page.
• Display USD/CNY exchange-rate charts for short-term and historical reference.
• Include HPOS compatibility declaration.

How It Works

Eezz FX Payout Estimator for WooCommerce uses four main settings:

1. Calculation Currency
   This is the currency used to interpret product prices, order amounts and fixed fees. In most stores, this should match the WooCommerce store currency.

2. Target Currency
   This is the currency used for payout estimates, reverse pricing, order estimates and dashboard reports.

3. Rate Service
   This is the base domain used to download the public exchange-rate bundle. The plugin stores the validated bundle locally.

4. Payment Profiles
   A payment profile describes the estimated cost of a payout channel, such as percentage fees, fixed fees, withdrawal fees or exchange-rate spread. The default profile is used by product helpers, order estimates and dashboard summaries unless another profile is selected in a supported admin screen.

The plugin then combines the cached exchange-rate data with the selected payment profile to estimate how much target currency may remain after fees and spread.

Getting Started

After activation, open Eezz FX Payout in the WordPress admin menu and complete these steps:

1. Open Rate Service.
2. Enter the official rate service base domain.
3. Choose the Calculation Currency.
4. Choose the Target Currency.
5. Save the settings.
6. Refresh the rate bundle.
7. Open Payment Profiles.
8. Create or edit a payment profile for your payout channel.
9. Choose a default payment profile.
10. Open a WooCommerce product or order to review payout estimates.

The Rate Service settings area may be locked after saving to help prevent accidental changes. Use Unlock settings before editing the rate service domain or currency settings again.

Product Price Helpers

On supported WooCommerce product edit screens, the plugin can display payout estimates beside product price fields. Administrators can use these estimates to understand how a product price may convert into a target-currency payout after payment profile costs.

The reverse pricing helper can also estimate the store price required to reach a desired target-currency payout amount. This is only an estimate and does not automatically change the product price unless an administrator chooses to copy or fill a calculated value.

Order Estimates

On WooCommerce order edit screens, the plugin can estimate target-currency payout values using current cached rates and the selected or default payment profile. These estimates are for administrative reference and do not change the order total, order currency, payment status or accounting records.

If an order currency is different from the selected Calculation Currency, the plugin may skip or label the estimate to avoid misleading results.

Dashboard Reports

The Dashboard summarizes recent store activity and estimated payout loss using cached local data. Reports are designed to help administrators review patterns and possible FX/payment loss, not to replace accounting reports.

Dashboard data may be cached for performance. If currency settings or payment profiles change, the plugin clears relevant report cache where needed.

Exchange-Rate Charts

The plugin stores selected exchange-rate history locally and can show short-term and historical chart views for reference. Historical rates are for reference only. They may not match the exact rate used by a payment provider, card network, bank or payout service at settlement time.

Important Notes

• Eezz FX Payout Estimator for WooCommerce is an admin-only tool.
• It does not add frontend checkout currency conversion.
• It does not modify WooCommerce product prices automatically.
• It does not modify WooCommerce order totals.
• It does not replace payment gateway reports.
• It does not guarantee actual payout amounts.
• It does not provide financial, accounting, legal, tax or currency exchange advice.

Privacy

Eezz FX Payout Estimator for WooCommerce does not upload order, product, customer or administrator data.

The plugin downloads a public exchange-rate bundle from the configured rate service and stores validated rate data locally. It does not register public REST endpoints for customer data, does not add frontend advertising and does not send WooCommerce order data to the rate service.

EEZZ.NET support links

This plugin displays a small static support and services card on its own plugin admin pages. The card contains optional links to EEZZ.NET business setup services, WordPress/WooCommerce custom development, and plugin feedback/contact pages.

The card does not load remote advertising scripts, does not load remote advertising images, does not track impressions or clicks, and does not add promotional links to the public frontend of the site.