Fungies for WooCommerce
| 开发者 | fungies |
|---|---|
| 更新时间 | 2026年6月1日 19:22 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Fungies for WooCommerce lets you sell digital products through your WooCommerce store while Fungies.io handles payments, taxes, and compliance as your Merchant of Record.
You keep full control of your storefront. Fungies takes care of the hard parts — payment processing, tax collection, invoicing, and regulatory compliance — so you can focus on your products.
How It Works
- Connect — Paste your Fungies API keys in WooCommerce → Settings → Fungies
- Sync — Your Fungies products are automatically imported into WooCommerce
- Sell — Customers browse your store and check out via Fungies hosted checkout
- Get Paid — Fungies processes the payment and sends a webhook to complete the WooCommerce order
- Stay in Sync — Orders, refunds, and subscriptions are kept up to date automatically
- Two-Way Product Sync — Pull OneTimePayment products from Fungies into WooCommerce AND push WooCommerce products to Fungies as OneTimePayment offers (name, description, price, featured image)
- Auto-Sync on Product Save — Editing a WooCommerce product automatically updates the matching offer in Fungies
- Currency Validation — Detects your Fungies workspace currency and warns if it differs from your WooCommerce store currency
- Multi-Item Hosted Checkout — Carts with multiple products create a Fungies Checkout Element so all line items appear on the hosted checkout page
- Detailed Sync Panel — Clear summary under "Sync Now" showing pull/push counts and per-product errors
- Duplicate Protection — Products pushed from WooCommerce to Fungies will not be re-imported as duplicates on the next pull
- Hosted Checkout — Customers are redirected to a secure Fungies checkout page to complete payment, then returned to your WooCommerce thank-you page
- Real-Time Order Sync — Webhooks keep WooCommerce orders in sync with Fungies payments, including completions, failures, and refunds
- Subscription Support — Handles subscription creation, renewal, and cancellation events from Fungies
- Sandbox / Staging Mode — Test the full flow with staging API keys and Stripe test cards before going live
- Secure Webhooks — All incoming webhooks are verified with HMAC-SHA256 signatures and protected against duplicate processing
- WooCommerce Blocks Compatible — Works with both the classic checkout and the new WooCommerce block-based checkout
- HPOS Compatible — Fully compatible with WooCommerce High-Performance Order Storage (custom order tables)
- Opt-In Debug Logging — Toggle verbose request/response logging in WooCommerce → Status → Logs (source:
fungies). Errors and warnings are always logged; verbose dumps are off by default to keep log files small and avoid storing third-party API payloads unless you're troubleshooting. - Dashboard Widget — See your sync status at a glance from the WordPress dashboard
- No payment gateway setup — Fungies handles Stripe, PayPal, and more
- Automatic tax collection — Sales tax, VAT, and GST handled globally
- Invoicing & compliance — Professional invoices generated for every transaction
- Fraud protection — Built-in fraud detection and chargeback handling
- Sell software, ebooks, courses, or any digital product
- Add a WooCommerce storefront to your existing Fungies catalog
- Let Fungies handle payments and taxes while you manage the shopping experience
- During product sync, the plugin sends your API keys to the Fungies API to retrieve your product catalog.
- During checkout, customers are redirected to the Fungies hosted checkout page. Their email address and country code are passed as URL parameters.
- During webhook processing, Fungies sends order and payment data (order ID, payment status, amounts, subscription details) to your WordPress site.
- Production API:
https://api.fungies.io/v0 - Staging API:
https://api.stage.fungies.net/v0 - Hosted checkout:
https://{your-store}.app.fungies.io
安装:
Automatic Installation
- Go to WordPress Admin → Plugins → Add New
- Search for "Fungies for WooCommerce"
- Click Install Now, then Activate
- Download the plugin
.zipfile - Go to WordPress Admin → Plugins → Add New → Upload Plugin
- Upload the zip file and click Install Now
- Click Activate
- Go to WooCommerce → Settings → Fungies
- Enter your Fungies API keys (Public Key, Secret Key, Webhook Secret)
- Enter your published Fungies Store URL
- Configure the webhook endpoint in your Fungies Dashboard → Developers → Webhooks
- Configure the post-purchase redirect URL in Fungies Dashboard → Settings → Store → Checkout tab
- Click Sync Now to import your products
屏幕截图:
常见问题:
Does the Fungies store need to be published?
Yes. The hosted checkout URL only works when your Fungies store is published. Go to the Fungies Dashboard and make sure your store is not in draft mode.
Which Fungies products are synced?
Only OneTimePayment products and their offers are synced into WooCommerce. Other product types (Digital Downloads, Subscriptions, Game Keys, etc.) are not imported. Product names and descriptions from Fungies are used for the WooCommerce product listings.
Can I use this alongside other WooCommerce payment gateways?
Yes. Fungies registers as a standard WooCommerce payment gateway. Customers can choose it at checkout alongside any other enabled gateways.
How often do products sync automatically?
Every hour via WordPress Cron. You can also trigger a manual sync anytime from the Fungies settings page.
How do I test without processing real payments?
Enable Sandbox Mode in the plugin settings, use staging keys from app.stage.fungies.net, and pay with Stripe test cards.
Why don't customers get redirected back after payment?
You need to configure the Instant Redirect URL in Fungies Dashboard → Settings → Store → Checkout tab. Use the Post-Purchase Redirect URL shown on the plugin settings page and add the Order ID and User Email URL parameters.
Do I need separate API keys for sandbox and production?
Yes. Production and staging environments in Fungies are completely separate. API keys, products, and webhooks are independent — staging keys will not work against the production API, and vice versa.
What webhook events should I enable?
Enable these events in your Fungies webhook configuration: payment_success, payment_failed, payment_refunded, subscription_created, subscription_interval, and subscription_cancelled.
What order metadata is stored?
When a payment succeeds, the plugin stores the Fungies order ID, order number, payment ID, payment type, subscription ID (if applicable), invoice URL, processing fee, and tax amount on the WooCommerce order.
Does it work with WooCommerce Blocks checkout?
Yes. The plugin is fully compatible with both the classic WooCommerce checkout and the new block-based cart and checkout experience.
更新日志:
2.4.4
- Fix: Customer email was not pre-filled on the Fungies hosted checkout page when redirecting from WooCommerce. Root cause:
Fungies_Checkout_URL_Builder::build()was sendingfngs-user-emailas the prefill query parameter, but per the official Fungies docs the prefill parameter isfngs-customer-email.fngs-user-emailis the outbound system parameter Fungies appends to the post-purchase Instant Redirect URL — not the inbound prefill param. Mixing the two meant the WC billing email was passed but ignored by Fungies, so customers had to retype their email at checkout. The plugin now sendsfngs-customer-emailfor prefill while still readingfngs-user-emailfrom the return URL (where Fungies appends it) — both names are now used in their correct directions. No data migration needed; existing orders are unaffected. - Docs: Corrected the URL examples in the readme to match.
- Lint: Replaced the three
phpcs:ignoreannotations added in 2.4.2 with properphpcs:disable/phpcs:enableblocks. The slow-query sniff fires on the'meta_key'/'meta_value'/'meta_query'array-key string tokens inside thewc_get_orders()/get_posts()literal, not on the outer call line, so the single-lineignoreform never reached them. AffectsFungies_Order_Sync::find_order_by_meta(),Fungies_Return_Resolver::by_meta(), andFungies_Product_Sync::push_to_fungies(). - No runtime behaviour changes.
- Security/correctness: Replaced two SQL queries in
Fungies_Workspace_Meta::get_all_pushed_offer_ids()andFungies_Product_Sync::cleanup_pushed_duplicates()that interpolated class constants directly into the SQL string with fully prepared statements using$wpdb->prepare()+$wpdb->esc_like(). Behaviour is unchanged — values were already trusted constants, but the new form is what WordPress.org Plugin Check requires and what static analyzers can verify. - i18n: Added the missing
/* translators: ... */comments above every gettext call that uses placeholders so translators see what each%s/%drefers to. Reworked'Connected to %s API! (%s)'into ordered placeholders'Connected to %1$s API! (%2$s)'per WP i18n guidelines. - Lint: Added narrow
phpcs:ignoreannotations with inline rationale on the handful of justified direct-DB / slow-query / nonce-check warnings (e.g. thewc-api=fungies_returnredirect handler reads$_GETfor read-only redirect logic and is paired with an HMAC-verified webhook; the direct postmeta lookups are single-row indexed reads). No new ignores were added blindly. - No runtime behaviour changes.
- Compliance: Added the
Requires Plugins: woocommerceheader introduced in WordPress 6.5. WordPress now refuses to activate the plugin unless WooCommerce is installed and active, and the WooCommerce dependency is shown in the Plugins screen. - i18n: Renamed the plugin text domain from
fungies-wptofungies-for-woocommerce(matching the plugin slug) across all 97 gettext calls and the plugin header. Required for the WordPress.org translation platform to pick up strings for community translation. Any custom.po/.mofiles keyed off the oldfungies-wpdomain must be re-generated. - No runtime behaviour changes.
- Security: Hardened the Fungies Store URL setting — the field is now an
<input type="url">and saves throughesc_url_raw, plus the runtime read site re-validates withesc_url_raw+wp_http_validate_urland rejects anything other thanhttp/httpsschemes before building a customer redirect. - Security: Added an HTTPS host allowlist (
fungies.io,fungies.net) before sideloading product images viamedia_sideload_image, mitigating SSRF risk from third-party image URLs. Extensible via thefungies_image_host_allowlistfilter. - Privacy: Verbose API request/response logging is now opt-in via a new WooCommerce → Settings → Fungies → Debug Logging checkbox. Errors and warnings are still logged unconditionally so genuine failures remain diagnosable; verbose dumps are off by default to keep log files small and avoid storing third-party API payloads unless troubleshooting.
- i18n: Wrapped two previously-untranslated admin AJAX error strings in
__()with translator comments and numbered placeholders. - Cleanup: Removed
console.log/console.errorcalls from the front-end Blocks checkout JS so the customer's browser console stays clean. - Docs: Inline rationale comment added above the webhook REST route's
permission_callback => '__return_true'explaining the HMAC-SHA256 signature verification, timing-safe comparison, and idempotency replay protection that act as the real auth. - Docs: Older changelog entries (2.1.x, 2.0.x, 1.x) moved to
changelog.txtper WP.org guidelines, keeping the readme focused on the current and previous major. - Build:
.gitattributesnowexport-ignoresREADME.md,build.ps1, andfungies-*.zipso the shipped plugin zip contains only runtime files. - Readme: Removed obsolete
Donate linkand theScreenshotssection (no screenshot assets shipped).
- Feature: Coupons are now pushed to Fungies the moment they are saved in WooCommerce, mirroring how products already work. Hook
save_post_shop_couponrunsFungies_Coupon_Sync::on_coupon_saved, which creates or updates the corresponding Fungies discount immediately — no need to wait for the hourly cron or click "Sync Now". Skipped silently for autosaves and revisions, debounced via a 5-second transient lock per coupon. - Feature: Deleting a coupon (
before_delete_post) now clears its workspace-scoped_fungies_pushed_discount_id__<hash>post meta, so re-creating a coupon with the same code creates a fresh Fungies discount instead of trying to update a stale ID.
- Feature: WooCommerce coupon codes applied at checkout are now forwarded to the Fungies hosted checkout via the
fngs-discount-codequery parameter, so the Fungies-side total automatically matches the WooCommerce-side total after discount. The first coupon code on the order is forwarded as-is — it is expected to match a Fungies discount code already synced via "Sync Now". No action needed on the Fungies dashboard side as long as the coupon was synced.
- Fix:
PATCH /v0/discounts/:id/updaterejected every coupon update withid: Requiredbecause the Fungies update schema demandsidin the request body in addition to the URL path. The API client now injects the discount UUID into the body automatically. - Fix: Coupon diff now correctly normalizes server-side amount storage. Fungies stores fixed-amount discounts in currency minor units (e.g.
1USD becomes"100"in responses), so the previous diff always reported "different" and triggered an update on every sync. The mapper now multiplies fixed amounts bywc_get_price_decimals()before comparing, and convertsvalidUntilfrom milliseconds to seconds before comparing.
- Fix: Coupon sync no longer aborts when the Fungies
GET /v0/discounts/listendpoint returns 500 because of pre-existing rows with negativevalidFromDates (a known server-side timezone bug). The plugin now falls back to a row-by-row walk that skips broken pages, and primarily relies on the local_fungies_pushed_discount_idpost meta to decide between create and update. - Fix: If an UPDATE call returns "not found" (e.g., the Fungies discount was archived/deleted manually), the plugin now clears the stale local mapping and creates a fresh discount instead of erroring.
- Note for existing installs: any duplicate
percent10/fixed1rows already in your Fungies workspace from a v2.2.0 install must be archived manually in the Fungies dashboard — the plugin can no longer see them through the broken LIST page.
- Fix: Fungies API rejects
validFrom: 0with "Number must be greater than or equal to 0" even though the spec lists 0 as valid. The coupon now sends the WooCommerce coupon's actualdate_createdtimestamp (or current time as fallback) forvalidFrom, which is also more semantically correct. - Fix:
purchaseLimitwas always sent — its create-schema enum forbidsnull, so coupons without a usage limit failed validation. The field is now only included when the WooCommerce coupon has a usage limit set. - Fix: When
GET /v0/discounts/listfails on the first page, the coupon sync now returns the API error instead of silently treating the remote index as empty (which could create duplicates on a transient outage).
- Feature: WooCommerce coupons are now synced to Fungies on every "Sync Now" run. Each coupon (
percent,fixed_cart,fixed_product) is created or updated as a Fungies discount with the same code, amount, amount type, expiration date, and usage limit. The Sync panel reports a third "Coupons → Fungies" line with created / updated / error counts. Mapping is workspace-scoped (sandbox vs production) so toggling Sandbox Mode does not orphan the link, and re-running Sync skips coupons that are already in sync. For changelog entries from earlier releases (2.1.x, 2.0.x, 1.x), seechangelog.txtin the plugin root.