To connect WooCommerce, you approve Wrapped in your WordPress admin, turn the sales channel on, install the free Wrapped Gift Card Redemption plugin so customers can pay with gift cards at checkout, and create a gift card product with the SKU wrapped_giftcard so customers can buy them. Wrapped creates gift cards for paid orders, meaning orders with the status Processing or Completed.
Choose how customers redeem gift cards
WooCommerce has no built-in gift cards, so you choose one of three ways. You pick it in the channel's Settings under Plugin, and you can change it later.
| Option | Cost | How customers redeem | Code rules | Guide |
|---|---|---|---|---|
| Wrapped Gift Card Redemption (recommended) | Free plugin from Wrapped | A Gift Card box at checkout. The balance is checked in Wrapped and taken off the order total. | Any Wrapped code | This article |
| WooCommerce Gift Cards | Paid WooCommerce extension | WooCommerce's gift card field at checkout | Exactly XXXX-XXXX-XXXX-XXXX | Use Wrapped with the WooCommerce Gift Cards plugin |
| Smart Coupons for WooCommerce | Paid WooCommerce extension | The coupon code field at checkout. The card works like a coupon and can be combined with other coupons. | Any code | Use Wrapped with Smart Coupons for WooCommerce |
With the Wrapped plugin, nothing is copied into WooCommerce: balances stay in Wrapped and are checked live. With the other two, Wrapped creates a copy of every gift card in WooCommerce and keeps its balance up to date.
Before you start
- Be an Owner or Admin in Wrapped, and sign in to WordPress as a user who can manage WooCommerce.
- Your store must be reachable over HTTPS at the address you enter.
- Have your store address ready, for example
yourstore.com.
Step 1: Connect your store
- In Wrapped, go to Settings › Sales channels (open) and select Add sales channel.
- Choose WooCommerce.
- Enter your WooCommerce store URL and select Connect.
- In WordPress, approve access for Wrapped.
- You're returned to Sales channels with the message "WooCommerce connected."
- Turn on the switch next to your store. It starts Disabled.
When you connect, Wrapped adds two WooCommerce webhooks (order created and order updated) so it hears about every order. You don't need to set these up.
Step 2: Install the Wrapped Gift Card Redemption plugin
Skip this step if you chose WooCommerce Gift Cards or Smart Coupons.
- On the WooCommerce channel in Settings › Sales channels, select Settings.
- Under Plugin, make sure Wrapped Gift Card Redemption (recommended) is selected.
- Select Download plugin to download the plugin zip file.
- Copy the Account platform ID and the API key shown under 2. Configure the plugin. Select Save.
- In WordPress, go to Plugins › Add New Plugin › Upload Plugin, upload the zip file, then select Activate.
- Go to WooCommerce › Wrapped Gift Card Settings.
- Paste the Account Platform ID and API Key, and save.
- Select Test Connection. You should see "Connection successful!"
The plugin adds a Gift Card section with an Apply Gift Card button to your checkout. You can change both labels in the plugin's Display Settings. It works with both the classic checkout and the block checkout.
To update the plugin later, download the latest version the same way and upload it over the old one.
Step 3: Create a gift card product
Customers buy gift cards through an ordinary WooCommerce product that Wrapped recognises by its SKU.
- In WordPress, go to Products › Add New Product.
- Name it, for example "Digital gift card", and choose Variable product.
- Set tax so that none is charged (for example, the Zero rate tax class).
- In Inventory, set the SKU to
wrapped_giftcard. - Add an attribute for the amount (for example $25, $50, $100) and create a variation for each.
- Give each variation a price and its own SKU that starts with
wrapped_giftcard, such aswrapped_giftcard_50. Mark the variations Virtual. - Publish the product.
Wrapped creates a gift card for every order line whose SKU contains wrapped_giftcard. A product without it is treated as an ordinary product and no gift card is created.
How the card is created:
- Value: the line's price before any coupon, divided by the quantity. A coupon that discounts the gift card product doesn't reduce the card's value.
- Tax: the value doesn't include tax, which is why the product should be zero-rated. If tax is charged, the customer pays more than the card is worth.
- Quantity: one gift card per unit. Buying three $50 cards creates three cards.
- Code: generated by Wrapped using your code format (see Gift card code format and each platform's rules).
- Email: sent to the order's billing email address.
- Expiry: your default gift card expiry, if you use one (see Gift card expiry).
If you prefer not to sell through WooCommerce, you can link to or embed your Wrapped web store instead (see Share, link to or embed your web store).
Which orders Wrapped processes
| Order | What Wrapped does |
|---|---|
| Paid, with status Processing or Completed | Creates gift cards for wrapped_giftcard lines and records gift card redemptions |
| Pending payment, On hold or Failed | Nothing yet. It's processed once it's paid. |
| Cancelled | Voids gift cards bought on the order (balance $0, status Disabled) and reverses redemptions Wrapped recorded for it |
| Refunded | Doesn't void gift cards bought on the order. Void them in Wrapped yourself (see Void or delete a gift card). |
| Placed before you connected the store | Never processed |
Each order is processed for gift cards once. Editing an order afterwards doesn't create extra cards.
How the redemption plugin works at checkout
- The customer enters their code and selects Apply Gift Card. The plugin checks the balance in Wrapped and takes the amount off the order as a Gift Card line.
- The balance comes off the card in Wrapped as soon as the card is applied, and Wrapped passes the new balance to your other channels.
- Removing the gift card from the cart puts the balance back.
- Customers can use more than one gift card on an order, and pay the rest with another payment method.
- If the order is later Cancelled or Refunded in WooCommerce, the plugin puts the gift card balance back and adds an order note. A Failed order keeps the redemption, because the customer can retry payment.
- Expired gift cards are rejected.
Test the connection
- On the channel in Settings › Sales channels, open Settings and select Test connection. You should see "Connected to" followed by your store address.
- In Wrapped, go to Gift cards › All gift cards › Issue gift card and issue a small gift card.
- Buy something in your store and apply the code at checkout. Check the balance goes down in Wrapped.
- Buy your gift card product with a low price or a test payment method, complete payment, and check the new card appears in Gift cards › All gift cards within a few minutes.
- Delete the test cards (… menu › Delete gift card) and refund or cancel your test orders.
The channel's Setup checklist walks through the same three steps and lets you tick them off.
Common questions
Only some orders created gift cards. Why?
Check the order was paid (status Processing or Completed), placed after you connected, and that the product line's SKU contains wrapped_giftcard. Then use Check orders on the channel to see what Wrapped did with each order (see Sales channel status).
Does Wrapped create gift cards before the order is completed?
Yes, as soon as the order is paid and its status is Processing or Completed. You don't need to mark it completed first.
Can customers use a Wrapped gift card and a coupon together?
With the Wrapped plugin, yes: the coupon applies as normal and the gift card is taken off the remaining total. With Smart Coupons, the gift card is itself a coupon and can be combined with other coupons.
I changed a balance in WooCommerce. Why didn't it update Wrapped?
Wrapped doesn't read balance changes made directly in WooCommerce. Adjust the balance in Wrapped instead and it's passed to every channel (see Adjust a gift card's balance).
Can I bring existing WooCommerce gift cards into Wrapped?
If you use WooCommerce Gift Cards, the Wrapped team can import your active cards (see Getting help). Otherwise, see Import existing gift cards from a CSV file.
Can I connect more than one WooCommerce store?
Yes. Connect each store address as its own sales channel.