Gift Credit

WalletPro gives customers two ways to gift wallet credit. A buyer can purchase a special "gift wallet credit" product that funds a recipient's wallet on payment, and a logged-in customer can send credit straight from their own balance using the Gift action on the My Account wallet dashboard. Both paths land the credit as a "Gift received" entry in the recipient's wallet.

Overview

WalletPro supports two distinct gifting paths, and both result in the recipient receiving wallet credit:

• Buying a gift as a product. A merchant flags a WooCommerce product as a gift. A buyer purchases it, names a recipient by email, and on payment the recipient's wallet is funded. This is a real purchase paid through the normal checkout.
• The Gift action on the wallet dashboard. A logged-in customer sends credit from their own wallet balance to another customer, identified by email, directly from My Account > Wallet. No payment is involved; the funds move from the sender's balance to the recipient's.

In both cases the recipient sees the credit as a Gift received entry in their wallet ledger, and the credit is part of their spendable wallet balance at checkout with no separate redemption step. Gifting is distinct from Redemption Codes (claimed with a code) and Milestone Rewards (granted automatically by spend thresholds).

Path 1: Buying a Gift as a Product

This path turns a normal WooCommerce product into a "gift wallet credit" item. The buyer pays for it like any other product, and the value lands in the recipient's wallet once the order is paid.

Setting Up the Gift Product (Merchant)

Edit any product and, in the Product data > General panel, you will find three WalletPro fields:

The buyer's chosen amount becomes the line price of the product, so the order total reflects exactly what the recipient will receive. If the buyer enters an amount outside the min/max band, WalletPro clamps it to the nearest bound rather than rejecting the order.

Buying a Gift (Shopper)

On a gift product page, the shopper sees these fields above the add-to-cart button:

• Recipient email (required): where the gift is delivered. Any valid email is accepted; the recipient does not need an existing account.
• Amount (required): the value of the gift, clamped to the product's min/max.
• Message (optional): a short note that travels with the gift.
• Delivery date (optional, YYYY-MM-DD): schedule the gift for a future day. Leave blank to deliver as soon as the order is paid.

The recipient email is shown in the cart and order so the buyer can confirm it before paying.

Fulfilment

When the order reaches a paid state (WalletPro listens on woocommerce_payment_complete and on the processing and completed order statuses), each gift line item is fulfilled:

• If the recipient email belongs to a registered user, their wallet is credited directly with a Gift received ledger entry.
• If the recipient email is not yet registered, WalletPro issues a held redemption code restricted to that email. When that email registers an account, the held credit is applied automatically (it can also be redeemed manually).
• If a delivery date is set in the future, fulfilment is deferred. A daily cron job (walletpro_daily_gifts) delivers gifts whose delivery date has arrived.

Refunds

If a gift order is refunded (the order moves to the refunded status), WalletPro reverses what it delivered:

• A direct credit is clawed back by debiting the recipient's wallet. The reversal is clamped to the recipient's current balance, so if they have already spent some of it, only what remains is taken back (the wallet is never driven negative by the reversal).
• A held code that has not yet been claimed is voided.

Developer Hook

After a gift line item is delivered, WalletPro fires an action so the email layer (or your own code) can notify the recipient:

add_action( 'walletpro_gift_fulfilled', function( $email, $amount, $order_id ) {
    // $email is the recipient address, $amount is a Balance, $order_id is the source order.
    // Send your own "you received a gift" message here.
}, 10, 3 );

Path 2: The Gift Action on the Wallet Dashboard

A logged-in customer can send credit straight from their own wallet balance to another customer. There is no purchase and no fee: the amount simply moves from the sender's wallet to the recipient's.

Where to Find It

On the My Account > Wallet page, an action bar sits at the top of the dashboard with four buttons: Add Funds, Gift, Transfer, and Statement. The Gift button jumps to the Send a gift form lower on the same page.

The Send a Gift Form

The form collects two fields:

• Recipient email (required): the recipient is resolved by email only. A gift is a deliberate "send to someone's inbox" action, unlike the Transfer form, which also accepts a username.
• Amount (required, minimum 0.01): how much credit to send from your balance.

The form is nonce-protected, and submission uses the Post/Redirect/Get pattern: after the gift is processed the page redirects back to the wallet dashboard, so refreshing the page cannot resend the gift. The outcome is shown as a notice on the dashboard.

Validation

Before any money moves, the request is gated by three pure rules, checked in this order:

An unparseable amount is rejected up front with "Please enter a valid amount." If the sender's balance cannot cover the gift, the move is refused with "Your balance is not sufficient for this gift." and nothing is recorded.

How the Money Moves (Money-safe)

A wallet gift uses the same atomic, compensating pattern as a wallet transfer, but with no fee, no limit settings, and no extra confirmation step:

1. The sender is debited first, through the single funds chokepoint. If the balance cannot cover the amount, the debit returns without recording or moving anything, and the customer sees the insufficient-balance message.
2. The recipient is then credited with a Gift received ledger entry.
3. If the credit leg fails (a rare database error after the debit already succeeded), the sender is compensated: the debited amount is credited back to them. The gift is all-or-nothing, so funds can never be lost or duplicated.

What Each Side Sees

The recipient's wallet ledger gains a Gift received entry described as "Gift from user #<sender>", increasing their spendable balance immediately. The sender's ledger shows the matching debit described as "Gift to user #<recipient>". The credited amount is ordinary wallet balance from then on and can be applied at checkout like any other funds.

Comparing the Two Paths