Developer API & Action Hooks

GateFuz is built with a developer-first decoupled architecture, providing clean action hooks for order fulfillment, subscription tracking, and custom gateway creation.

Integrations & Connected Ecosystem

GateFuz acts as the centralized transaction engine and subscription manager for your WordPress installation. Connected products share the same gateway configurations, webhooks, transaction ledgers, and customer subscriptions with zero duplicate setup:

Developer Quick Start & Hooks Reference

The built-in Developer Hub provides copy-paste ready implementations for checkout forms, order fulfillment listeners, subscription lifecycles, and direct PHP APIs:

---

1. Payment Completion Hook (Order Fulfillment)

When any gateway completes payment (via instant return or verified webhook), GateFuz records the transaction and fires gatefuz_payment_completed:

add_action( 'gatefuz_payment_completed', function( $orderId, $transactionData ) {
    $userId          = (int) $transactionData['user_id'];
    $amount          = (float) $transactionData['amount'];
    $currency        = $transactionData['currency'];
    $gateway         = $transactionData['gateway'];        // 'stripe', 'paypal', etc.
    $gatewayTxId     = $transactionData['gateway_tx_id'];  // e.g. pi_3Mtw27...
    $customerEmail   = $transactionData['customer_email'];
    $subscriptionId  = $transactionData['subscription_id'];

    // 1. Grant digital access or membership:
    // update_user_meta( $userId, 'membership_level', 'pro_plan' );

    // 2. Mark internal invoice or order as paid:
    // my_app_mark_order_paid( $orderId, $gatewayTxId );
}, 10, 2 );

---

2. Refund Synchronization Hook

When a refund is processed via API or synchronized via gateway webhook:

add_action( 'gatefuz_payment_refunded', function( $transactionId, $gateway, $metadata ) {
    // Revoke access or flag license as refunded:
    // my_app_revoke_license( $transactionId );
}, 10, 3 );

---

3. Subscription Lifecycle Hooks

Subscription Created

add_action( 'gatefuz_subscription_created', function( $subscriptionId, $subscriptionData ) {
    // $subscriptionData contains user_id, plan_id, gateway, amount, status
}, 10, 2 );

Free Trial Started

add_action( 'gatefuz_subscription_trial_started', function( $subscriptionId, $userId, $trialEnd, $data ) {
    // Grant trial access until $trialEnd (Y-m-d H:i:s)
}, 10, 4 );

Subscription Renewed

add_action( 'gatefuz_subscription_renewed', function( $subscriptionId, $transactionData ) {
    // Extend access period by another billing interval
}, 10, 2 );

Subscription Canceled

add_action( 'gatefuz_subscription_canceled', function( $subscriptionId ) {
    // Schedule deactivation at end of period
}, 10, 1 );

---

4. Custom Checkout Amount Verification Filter

add_filter( 'gatefuz_verify_checkout_amount', function( $isValid, $amount, $currency, $token, $orderId ) {
    // Custom database validation or wholesale customer price validation
    return $isValid;
}, 10, 5 );