GateFuz – Universal Payment Gateways
| 开发者 |
vinoth06
buffercode |
|---|---|
| 更新时间 | 2026年10月19日 19:28 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
GateFuz is a modern, decoupled payment gateway engine and transaction ledger for WordPress. It provides a unified checkout interface for one-time payments, administrative subscription tracking and synchronization via webhooks, and centralized transaction management with zero foreign plugin dependencies.
For detailed Doc - https://faq.gatefuz.com
Key Highlights
- Gutenberg Block Support: Insert and configure the GateFuz Payment Box directly in the Block Editor with live visual preview and custom sidebar controls.
- 7 Global Payment Gateways: Stripe, PayPal Smart Buttons, Razorpay (UPI, Netbanking), Mollie (iDEAL, Bancontact), Paystack (Africa), Braintree, and Direct Bank Wire.
- Dual Key Credentials: Isolated Test and Live credentials across all API gateways. Toggle between Sandbox and Production with a single click.
- Subscription Tracking & Webhook Sync: Maintain an administrative subscription ledger to track customer status, record trial periods, and synchronize subscription lifecycle events received via gateway webhooks.
- Manual Transaction & Subscription CRUD: Full administrative controls to add, view, or manage transactions and link them directly to subscription IDs.
- Start-to-End Diagnostic Logging: Built-in transaction lifecycle observer with a live debug viewer and server environment health diagnostics.
- Ecosystem Ready: Seamlessly connects with Frontend Dashboard (FED), AdFuz Advertising Engine, BufferCode products, or custom bespoke plugins and themes.
- Developer First Architecture: Trigger checkouts with the Block Editor, shortcode
[gatefuz_checkout], or PHP actiondo_action('gatefuz_render_checkout').
安装:
- Upload the
gate-fuzdirectory to your/wp-content/plugins/directory. - Activate the plugin through the 'Plugins' menu in WordPress.
- Navigate to GateFuz > Gateways to configure your Live and Test API credentials.
- Set up webhook endpoints in your gateway developer dashboards.
- Embed checkout anywhere using the GateFuz Payment Box Gutenberg block, the shortcode
[gatefuz_checkout amount="49.00" currency="USD"], or PHP hookdo_action('gatefuz_render_checkout', 49.00, 'USD').
屏幕截图:
常见问题:
Is GateFuz completely independent?
Yes. GateFuz is a 100% standalone plugin with its own dedicated database tables (wp_gatefuz_transactions and wp_gatefuz_subscriptions) and zero foreign dependencies.
How do dual Test and Live keys work?
Every supported gateway stores both your Test and Live credentials simultaneously. When you toggle Test Mode on or off in gateway settings, GateFuz switches between test and production without re-entering credentials.
Can I use GateFuz with custom plugins or themes?
Yes. Developers can trigger the checkout modal via do_action( 'gatefuz_render_checkout', $amount, $currency ) and listen for verified payments using add_action( 'gatefuz_payment_completed', ... ).
How do I display the payment checkout box on my site?
You can insert the GateFuz Payment Box block in the Block Editor, or add the shortcode [gatefuz_checkout amount="49.00" currency="USD"] to any WordPress page, post, or block editor content. You can adjust the amount and currency attributes as needed (e.g. [gatefuz_checkout amount="25.00" currency="EUR"]). Alternatively, theme and plugin developers can render the payment box programmatically using do_action( 'gatefuz_render_checkout', 49.00, 'USD' );.
Does GateFuz create recurring subscriptions during checkout?
No. The frontend checkout modal and Gutenberg block process one-time payments. Subscriptions created in external gateway dashboards (or added manually by administrators) are tracked and synchronized in the built-in Subscriptions Ledger via gateway webhooks.
How can customers view their transaction history and receipts?
GateFuz automatically connects to Frontend Dashboard's native Payments menu tab, allowing logged-in customers to view their total spent, completed transaction counts, gateway badges, and view/print clean receipt modals.
Is there a shortcode to display customer payment transactions anywhere?
Yes. You can place the [gatefuz_transactions] (or alias [gatefuz_my_transactions]) shortcode on any WordPress page or post. It accepts optional attributes such as [gatefuz_transactions limit="10" show_header="yes" title="Billing & Invoices"].
Can I use Gutenberg to display customer transaction history?
Yes. GateFuz includes a native Gutenberg block called "GateFuz Customer Transactions" (gatefuz/transactions) with real-time canvas preview and sidebar Inspector Controls (Limit, Title, Show Header).
Where are Invoices, Receipts, and Company Billing details configured?
Invoices, brand logos, company registered addresses, tax/VAT numbers, invoice prefixes, and printable receipt templates are centralized directly inside GateFuz under GateFuz > Invoices. GateFuz automatically imports and stays synchronized with fed_invoice_settings so existing Frontend Dashboard users do not lose any company billing information. The legacy Payments menu in Frontend Dashboard has been deprecated in favor of GateFuz.
Can administrators track revenue breakdown across ecosystem products?
Yes. GateFuz features a dedicated "Revenue by Product & Ecosystem Source" breakdown widget directly on the main Dashboard. It displays lifetime gross earnings, completed order counts, average order values, and visual contribution percentage bars across Pay Per Post, Memberships Pro, WooCommerce / General checkouts, and manual administrative adjustments.
Can I export transaction records and audit logs to CSV?
Yes. Administrators can export the entire unified transaction ledger or filtered views (by payment gateway, payment status, customer search, or product ecosystem source) to CSV with 1 click directly from the GateFuz Dashboard or the Transactions Ledger. The exported CSV file includes UTF-8 BOM encoding for Microsoft Excel and formula injection protection.
更新日志:
1.1.3
- Feature: Revenue by Product & Ecosystem Source Widget: Added dedicated product earnings breakdown widget on the GateFuz Dashboard, displaying lifetime volume, completed order counts, average order value, percentage contribution share, and a proportional color-coded stacked bar across Pay Per Post (
fed_pay_per_post), Memberships Pro (fed_membership), WooCommerce / General (general), and Manual adjustments (manual). - Feature: Transactions CSV Export Engine: Added 1-click CSV export in the Transactions Ledger (
GateFuz > Transactions) and on the Dashboard widget, supporting full export filtering by payment gateway, transaction status, product ecosystem source, and search terms with formula injection defense. - Feature: Ecosystem Source Filter: Added dedicated product/source filter dropdown in the Transactions Ledger allowing instant isolation of transactions originated by Pay Per Post, Memberships Pro, or general checkouts.
- Feature: Direct Stripe API Online Refunds: Added programmatic refund execution (
StripeGateway::refundTransaction()) directly in the Transaction Ledger (GateFuz > Transactions), dispatching real-time refund requests to Stripe and synchronizing transaction status torefunded. - Feature: Interactive Transaction Refund Modal: Administrators can initiate full or partial refunds with confirmation details, refund reason notes, and live AJAX processing indicators.
- Feature: FED Gateway Adapter Refund Contract: Fully implemented
PaymentGatewayInterface::refundinFEDGatewayAdapter, enabling Frontend Dashboard add-ons (such as Pay Per Post) to trigger refunds via GateFuz without foreign dependencies. - Feature: Customer Payments Status Badges: Enhanced Frontend Dashboard Customer Payments view with color-coded status badges for
Completed(emerald),Refunded(rose),Pending(amber), andFailed(slate). - Performance: Version-Gated Database Migrations: Replaced unconditional
createTable()execution onplugins_loadedwith a version-gated migration check (gatefuz_db_version). Database tables are provisioned withCREATE TABLE IF NOT EXISTSon activation or upgraded only when the plugin version increments, eliminating repeated schema checks and file I/O on every page load.
- Feature: Centralized Invoices & Billing Profile Manager: Added dedicated administrative interface (
GateFuz > Invoices) to configure legal company entity, brand logo with live media selector, tax/VAT identification number, official address, custom invoice prefix/suffix, accent color picker, and payment terms, complete with interactive live receipt preview. - Feature: Stripe Subscriptions & Free Trial Engine: Added native support for free trials (
trial_period_days) via Stripe Subscriptions API. Automatically provisions Stripe Customers, Stripe Products (prod_...), and recurring Prices (price_...), attaching the customer's payment method so recurring renewal charges occur seamlessly when trials expire. - Feature: Split Setup Fee & Free Trial Payment Processing: Supports charging an immediate one-time setup fee while simultaneously initializing a zero-cost recurring trial subscription.
- Feature: Manual Gateway Synchronization & Webhook Reconciliation: Added per-subscription "Sync" action and "Sync All with Gateway" batch tool in the Subscriptions manager (
GateFuz > Subscriptions). Reconciles live lifecycle states (active,trialing,canceled), pulls paid invoices directly from Stripe REST API, records missing payment transactions, and automatically extends membership access. - Feature: Streamlined Metric Stat Pills & Clean Currency Formatting: Aligned customer dashboard stat boxes (
Total Paid: $10.00andOrders: 1) to a modern single-line horizontal layout, eliminating duplicate currency code suffixes ($10.00 USD->$10.00) and ensuring amounts stay cleanly formatted across all receipt views. - Fix: Stripe Elements Remounting Lifecycle: Added comprehensive unmount and destroy cleanup helpers (
destroyStripe,window.gatefuzResetStripe) and self-healing target checks to automatically re-initialize Stripe card inputs whenever the checkout modal is closed and re-opened. - Fix: Checkout Modal Price Layout & Clearance: Added visual clearance (
flex-shrink: 0; white-space: nowrap) to prevent the header price and interval text from colliding or overlapping with the circular close button.
- Feature: Frontend Dashboard Customer Payments Integration: Seamlessly hooks a dedicated Customer Payments & Receipts ledger into Frontend Dashboard's native Payments tab (
fed_frontend_dashboard_menu_container_payments). - Feature: Standalone Shortcodes: Added
[gatefuz_transactions](and alias[gatefuz_my_transactions]) with customizablelimit,show_header, andtitleattributes to display the billing ledger anywhere in WordPress. - Feature: Gutenberg Block: Added native 'GateFuz Customer Transactions' block (
gatefuz/transactions) with live block editor canvas preview, Inspector Controls (Limit, Title, Show Header), and dynamic server-side rendering. - Feature: Printable Modal Receipts: Customer transaction history includes an interactive "View" receipt modal with transaction metadata and a one-click "Print Receipt" button.
- Security & Resiliency: Added button debouncing, payment submission state locking, and order concurrency guards to prevent double-charges and duplicate transaction entries during checkout.
- Enhancement: Added contextual order metadata preservation (
plan_id,membership_id, customer parameters) through checkout rendering and gateway webhook fulfillment hooks. - Enhancement: Added high-contrast Frontend Dashboard design tokens to ensure readable typography across all WordPress themes.
- Enhancement: Added dedicated Online Documentation Portal banner and header link to https://faq.gatefuz.com in the WordPress Admin FAQ view (
views/admin/faq.php). - Enhancement: Added official brand logo and dashboard screenshots to
assets/images/for administration documentation.
- Enterprise Transaction Handling & Resiliency Suite:
- Idempotency & Duplicate Webhook Protection: Enhanced TransactionManager ledger to prevent duplicate transaction records and redundant fulfillment hook triggers (
gatefuz_payment_completed) upon receiving replayed or duplicate webhook events across Stripe, PayPal, Razorpay, Mollie, and Paystack. - Server-Side Webhook Reconciliation & Mismatch Guard: Added verification on incoming webhooks to validate paid amounts and currencies against pre-existing orders, instantly flagging discrepancies for administrator review rather than marking unverified charges as completed.
- Unified Refund Ledger Synchronization: Added
TransactionManager::markAsRefundedto synchronize refund states directly into the transaction database upon processing or receiving refund webhook events. - Provider Timeout & Recovery Pre-check: Added order lookup recovery upon upstream API timeouts before failing or retrying charges in Stripe and PayPal.
- Enhanced Asynchronous Lifecycle States: Extended webhook drivers to record
pending,cancelled, andfailedevents properly in the ledger. - Full Edge-Case Webhook Telemetry: Updated settings and status diagnostics with full edge-case webhook event badges and one-click copy buttons (
payment_intent.processing,payment_intent.canceled,payment_intent.payment_failedfor Stripe;PAYMENT.CAPTURE.PENDING,PAYMENT.CAPTURE.REFUNDED,PAYMENT.CAPTURE.DENIEDfor PayPal;payment.authorized,refund.processedfor Razorpay).
- Added programmatic refund processing support to Stripe gateway (
StripeGateway::processRefund), enabling automated full and partial refunds via Stripe REST API.
- Security Fix: Prevent unauthenticated payment amount tampering in checkout AJAX processing (
gatefuz_process_checkout). Added server-side cryptographic HMAC signature verification (wp_salt('nonce')+hash_hmac('sha256')+hash_equals()) to guarantee payment amount and currency integrity between rendered forms and backend transaction initiation. Thanks to pnn219 for responsibly discovering and reporting this vulnerability. - Added filter hook
gatefuz_verify_checkout_amountfor custom checkout verification workflows.
- Added Enterprise Dashboard Analytics & Performance Hub: interactive responsive SVG sales velocity chart with cubic Bezier curves, gradient area fill, crosshair tracking, floating tooltips, dynamic time range filters (7D, 30D, 90D, 1Y), and Volume vs Order metric toggles.
- Added Real-Time KPI Telemetry Badges: period gross volume, completed order count, Average Order Value (AOV), and conversion success rate.
- Added Payment Gateway Volume Distribution: interactive SVG donut meter with per-channel volume share, percentage metrics, and branded progress bars.
- Added Gutenberg Block
gatefuz/checkoutto insert and configure the GateFuz Payment Box directly in the WordPress Block Editor with live canvas preview and inspector controls (Amount, Currency, Billing Interval, Title, Subtitle). - Redesigned Global Settings into a categorized tabbed interface (Store & Currency, Redirection & Pages, Advanced & Logging) supporting instant client-side tab switching and persistent deep links.
- Added Global Checkout Redirection: AJAX-powered Searchable Page Finder for Payment Success (Thank You page), Payment Failure/Cancel, and Default Return URL (3D Secure / SCA) that scales to thousands of pages, complete with live "View Page" preview and custom external URL override.
- Added comprehensive Paystack configuration fields for isolated Sandbox and Live API credentials (Secret Key, Public Key).
- Added dedicated Webhook Secret field for Razorpay and Webhook ID fields for PayPal (Sandbox & Live).
- Strictly enforced cryptographic signature verification on Stripe, PayPal, and Braintree webhooks without unauthenticated fallbacks.
- Added interactive Recommended Webhook Events helper cards with one-click copy buttons across Stripe, PayPal, Razorpay, and Paystack.
- Enhanced Stripe PaymentIntent return URL resolution with automatic fallback hierarchy and 3D Secure / SCA redirect compliance.
- Updated conditional frontend asset enqueuing to automatically detect block usage via
has_block().
- Code review issues were fixed.
- Initial standalone release.
- Added Stripe, PayPal, Razorpay, Mollie, Paystack, Braintree, and Bank Transfer.
- Added dual Test and Live credentials across all API gateways.
- Added Transaction Ledger with manual CRUD and subscription linking.
- Added Start-to-End Transaction Lifecycle & Debug Logger.
- Added Tabbed Status & Logs diagnostics.
- Added Tabbed Integrations & Developer Hub.