Hooks Reference (Actions & Filters)

​

Essential Filters

​

woo_wallet_current_balance

• Parameters: (float) $balance, (int) $user_id.
• Example: Add a temporary 5% bonus to all balance displays.

add_filter( 'woo_wallet_current_balance', function( $balance, $user_id ) {
    return $balance * 1.05;
}, 10, 2 );

​

woo_wallet_payment_is_available

• Parameters: (bool) $is_available.
• Example: Disable wallet payment for a specific product category.

​

woo_wallet_cashback_amount

• Parameters: (float) $cashback_amount, (int) $order_id.

​

woo_wallet_disallow_negative_transaction

• Parameters: (bool) $disallow, (float) $amount, (float) $balance.
• Example: Allow a “Credit Limit” for trusted users.

add_filter( 'woo_wallet_disallow_negative_transaction', function( $disallow, $amount, $balance ) {
    if ( current_user_can( 'manage_options' ) ) {
        return false; // Allow admins to go negative
    }
    return $disallow;
}, 10, 3 );

​

Essential Actions

​

woo_wallet_transaction_recorded

• Parameters: (int) $transaction_id, (int) $user_id, (float) $amount, (string) $type.
• Example: Send a custom SMS notification when balance is updated.

​

woo_wallet_payment_processed

• Parameters: (int) $order_id, (int) $transaction_id.

​

woo_wallet_admin_adjust_balance

• Parameters: (int) $user_id, (float) $amount, (string) $payment_type.

​

woo_wallet_credit_purchase_completed

• Parameters: (int) $transaction_id, (object) $order.

​

Customizing Partial Payments

​

woo_wallet_partial_payment_amount

• Parameters: (float) $amount.
• Example: Always cap partial payments to 50% of the total order.

add_filter( 'woo_wallet_partial_payment_amount', function( $amount ) {
    $cart_total = WC()->cart->get_total('edit');
    return min( $amount, $cart_total / 2 );
} );

​

Recently Added Hooks (1.6.1–1.6.4)

​

Example: add a dashboard summary card

add_filter( 'woo_wallet_dashboard_stat_cards', function( $cards, $user_id ) {
    $cards['withdrawn'] = array(
        'id'       => 'withdrawn',
        'priority' => 80,
        'tone'     => 'neutral',
        'icon'     => 'wallet',
        'label'    => __( 'Total withdrawn', 'your-textdomain' ),
        'value'    => your_get_total_withdrawn( $user_id ),
    );
    return $cards;
}, 10, 2 );