Compatibility and Integrations

Gift Cards has been designed from the ground up to follow WooCommerce conventions and sound engineering practices. However, we cannot guarantee that every plugin and payment gateway will work seamlessly and predictably with it.

Supported Extensions

↑ Back to top

Our team has tested and officially supported the following extensions for use with gift cards. This list is not exhaustive. Other extensions and third-party plugins may work with Gift Cards without issues. However, our team can only officially support the extensions listed here.

ExtensionIntegration Details
WooCommerce BlocksView
Print Invoices and Packing ListsView
Conditional Shipping and PaymentsView
Woo SubscriptionsView
All Products for Woo SubscriptionsView
Name Your PriceView

WooCommerce Blocks

↑ Back to top

The integration makes Gift Cards compatible with the new Cart and Checkout blocks.

Limitations:

  • Existing integrations between Gift Cards and other extensions may not work as expected when using the block-based Checkout.

Print Invoices and Packing Lists

↑ Back to top

The integration ensures that used gift card amounts are correctly displayed in Invoices created with Print Invoices and Packing Lists.

Conditional Shipping and Payments

↑ Back to top

The integration between Gift Cards and Conditional Shipping and Payments:

  • Makes it possible to conditionally prevent customers from paying with gift cards.
  • Adds two new conditions — Gift Card Product and Gift Cards.

Limitations:

  • The integration between Gift Cards and Conditional Shipping and Payments has only been tested with the shortcode-based Cart and Checkout. It does not include Store API support, and will not work as expected with the new Cart and Checkout Blocks.

Restricting Payments with Gift Cards

The integration allows you to create Payment Gateway restrictions to conditionally prevent customers from paying with Gift Cards. Here’s an example:

Prevent orders from being paid using gift cards if the Shipping State is California.

Using Gift Cards in Conditions

The Gift Card Product condition allows you to prevent customers from using certain Payment Gateways while purchasing gift cards. Here is an example:

The Gift Cards condition allows you to prevent customers from using certain Payment Gateways when their order is partially paid using gift cards. Here is an example:

For more details on all available gift card-related conditions and their modifiers refer to the Conditional Shipping and Payments documentation.

Woo Subscriptions

↑ Back to top

The integration with Woo Subscriptions allows customers to pay for subscriptions and subscription renewals using their gift cards balance.

Limitations:

  • The integration between Gift Cards and WooCommerce Subscriptions has only been tested with the shortcode-based Cart and Checkout. It does not include Store API support, and may not work as expected with the new Cart and Checkout Blocks.

First, make sure that the feature is available and enabled on your store. With Gift Cards installed and activated, log in to your WordPress dashboard and:

  1. Navigate to WooCommerce > Settings> Subscriptions.
  2. Locate the Let customers pay for renewals using their Gift Cards account balance option.
  3. Make sure that the option is enabled. If not, tick its box and save your changes.

Once you have followed these steps, customers will see a handy Pay with Gift Cards Balance toggle button when viewing their subscriptions:

Note that: 

  • Pay with Gift Cards Balance is only available with subscription payment methods that support automatic recurring payments. Gift Cards will not automate renewal payments with payment gateways that don’t natively support this feature.
  • When Pay with Gift Cards Balance is enabled, WooCommerce will attempt to use the gift cards balance of the customer’s account, and fall back to the chosen payment method for any outstanding amount. For example, if a subscription renewal costs $50 and a customer’s account has only $20 available from redeemed gift cards, then WooCommerce will use those $20 and cover the remaining $30 via the “conventional” payment gateway chosen by the customer.
  • It is not possible to apply individual gift card codes to subscriptions. Subscribers who wish to use their gift card codes to pay for subscription renewals will need to “store” their codes in their accounts.

All Products for Woo Subscriptions

↑ Back to top

The integration with All Products for Woo Subscriptions allows you to sell simple or variable gift cards on subscription. Every time a gift card product subscription is renewed, a new gift card code is issued and e-mailed to its recipient.

Name Your Price

↑ Back to top

The integration with Name your Price makes it possible to let customers choose a custom price/value when purchasing prepaid gift cards. Store Managers can also:

  • suggest a price for gift card products; and optionally
  • enforce a minimum price.

Extensions with caveats

↑ Back to top

We’ve found the following workarounds that you can use. However, we can’t provide support for them.

Gift Cards and Advanced Dynamic Pricing for WooCommerce

When Advanced Dynamic Pricing for WooCommerce is active and a Gift Card is applied on the checkout page, then totals are not updated correctly once the Gift Card is applied. To resolve this issue, you can use the following snippet:

add_filter( 'wdp_calculate_totals_hook_priority', function( $priority ) { 	return 999; } );

Gift Cards and WooCommerce Multi-Currency

When WooCommerce Multi-Currency is active, customers can change the store’s currency and pay in whichever currency they desire.

However, if customers buy a Gift Card then the amount is always shown in the store’s default currency in the Gift Card e-mails.

Supported Payment Gateways

↑ Back to top

The following payment gateways have been tested with Gift Cards successfully. This list is not exhaustive: Other payment gateways may exist that work with Gift Cards without issues.

GatewayNotes
PayPal Standard—
PayPal Checkout—
PayPal Powered by Braintree—
Stripe—
Klarna Payments—
Authorize.Net—
Payfast—
FirstData—
Klarna CheckoutKlarna Checkout v2.2.0+ is required.

Unsupported Payment Gateways

↑ Back to top

The following payment gateways have known compatibility issues with Gift Cards. This list is not exhaustive. Other payment gateways may exist that do not work with Gift Cards as expected.

GatewayIssue Description
PayTabsPayTabs supports only physical products. Gift Cards are virtual/digital products. Therefore, it is not possible to use PayTabs to purchase Gift Card products.
SquareSquare throws intermittent “amount mismatch” errors with gift card plugins that filter the order total directly.

Gift Cards and Square

We have received several compatibility issue reports about Square’s handling of Gift Cards in the past.

After testing these two plugins together, we found out that Square recalculates order totals based on the prices of the individual cart items and compares the result of this calculation with the order total generated by WooCommerce core. If these totals do not match (for example, when a Gift Card is used), then Square does a price adjustment.

This adjustment happens in the woocommerce-square/includes/gateway.php class and specifically the do_transaction() method.

This is the error that customers usually see:

Square Payment Failed (Status code VALUE_TOO_LOW: total requested amount 0 is below the minimum allowed) Order status changed from Pending payment to Failed.

Moreover, after testing Square with the two other official Gift Cards extensions (PDF Product Vouchers and PW WooCommerce Gift Cards), we experienced the same error. It is highly possible that other third-party Gift Cards plugins are affected by this issue too.

Questions & Support

↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.
Already purchased and need assistance? Get in touch with us via the Help Desk!