Title: CardV Gift Cards Author: cardvnetservice Published: October 12, 2026 Last modified: October 20, 2026 --- Search plugins ![](https://ps.w.org/cardv-gift-cards/assets/banner-772x250.png?rev=3740505) ![](https://ps.w.org/cardv-gift-cards/assets/icon-256x256.png?rev=3740505) # CardV Gift Cards By [cardvnetservice](https://profiles.wordpress.org/cardvnetservice/) [Download](https://downloads.wordpress.org/plugin/cardv-gift-cards.1.1.0.zip) * [Details](https://wordpress.org/plugins/cardv-gift-cards/#description) * [Reviews](https://wordpress.org/plugins/cardv-gift-cards/#reviews) * [Installation](https://wordpress.org/plugins/cardv-gift-cards/#installation) * [Development](https://wordpress.org/plugins/cardv-gift-cards/#developers) [Support](https://wordpress.org/support/plugin/cardv-gift-cards/) ## Description CardV Gift Cards connects your WooCommerce store to your CardV merchant account. You pick the gift cards you want to sell, the plugin creates the products, and when a customer pays, the codes are bought from CardV and delivered on the order page and in the order e-mail. **What it does** * Browse the CardV catalog from your WordPress admin and import products with one click. * Fixed-value cards become one product with a choice of amounts, from lowest to highest face value. Cards with a custom amount get an amount field with live price preview. * Products are filed under CardV categories (or your own) and WooCommerce brands, with the brand logo and product image from CardV. * Works with any WooCommerce theme. Themes and other plugins can read gift card data through a documented function and the WooCommerce Store API. * Prices follow your markup, for the whole store or per card, and never go below your minimum margin. If the cost rises, the plugin protects you from selling at a loss. * Catalog, cost and stock are synced on a schedule you choose (default every 6 hours). * After payment, codes are delivered automatically, or held for your review based on rules you set: payment method, order size, orders per customer and per IP, first-order limit and country checks. * Codes are stored encrypted and shown only to the customer who bought them. Admin e-mails never contain codes. * Sandbox mode for testing with no real money. **What you need** * A WooCommerce store. * An approved CardV merchant account with API keys. Apply at [cardv.net](https://cardv.net/). * A prepaid CardV balance. Orders are paid from this balance. You are the seller of record to your customers. You set your prices, decide which orders are delivered automatically and handle your customers’ support and refunds. ### External services This plugin connects to the CardV Merchant API, operated by CardV, to work. It cannot function without it. * **What it is used for:** reading your account and balance, reading the product catalog and prices, getting price quotes, placing gift card orders and reading their status and codes. * **What is sent and when:** - When you test the connection, open the Products page, or the scheduled sync runs: your API key ID and signed request, plus catalog filters (no customer data). - When a paid order is fulfilled: the products, amounts and quantities, the expected unit price and an order reference made from your site and WooCommerce order number. No customer name, e-mail, address or payment data is sent. - When you open the Products page, import, sync or fulfil an order: price quotes for the cards involved. - On every sync, only if your store does not sell in USD: your store currency code, to read the exchange rate from USD. CardV checks its rates against several public sources; the plugin contacts no other service for it. - Every hour: your balance. Every few minutes while an order is waiting for its codes, and when a notification arrives: the order status, by CardV order number. - Every request carries the plugin, WordPress and WooCommerce version numbers( User-Agent) and comes from your server’s IP address. The order reference contains a short hash of your site address and the WooCommerce order number. - While you browse CardV > Products, card logos are shown directly from CardV image hosts (`*.cardv.net`), so your browser loads those images from CardV. When you import a product, and when CardV changes an image the plugin added, the product image and the brand logo are copied into your Media Library. Images you set yourself are never replaced. * **Incoming:** CardV may send signed order-status notifications to this site’s REST endpoint `/wp-json/cardv-gift-cards/v1/webhook`. Requests that are not signed with your webhook secret are rejected. * **Endpoints:** `https://b2b.cardv.net/api/v1/` (live) and `https://sandbox.cardv. net/api/v1/` (sandbox). * **Service provider:** CardV, [https://cardv.net/](https://cardv.net/) * **Terms of service:** [https://cardv.net/terms/](https://cardv.net/terms/) * **Privacy policy:** [https://cardv.net/privacy/](https://cardv.net/privacy/) ## Screenshots [⌊Overview with balance, products and orders that need you.⌉⌊Overview with balance, products and orders that need you.⌉[ Overview with balance, products and orders that need you. [⌊Import products from the CardV catalog.⌉⌊Import products from the CardV catalog .⌉[ Import products from the CardV catalog. [⌊Choosing an amount on the product page.⌉⌊Choosing an amount on the product page .⌉[ Choosing an amount on the product page. [⌊Gift card codes on the order page.⌉⌊Gift card codes on the order page.⌉[ Gift card codes on the order page. [⌊Price and delivery rules.⌉⌊Price and delivery rules.⌉[ Price and delivery rules. ## Installation 1. Install and activate WooCommerce. 2. Install this plugin from Plugins > Add New, or upload the zip, then activate it. 3. Open **CardV > Settings**, choose Sandbox, paste your API key ID, signing secret and webhook secret, and save. The plugin tests the connection. 4. Copy the webhook URL shown on the Settings page into your CardV Portal. 5. Open **CardV > Products**, select the cards you want to sell and import them. 6. Review your price and delivery rules, then switch to Live when you are ready. ## FAQ ### Do I need a CardV account? Yes. The plugin sells CardV products and pays for them from your CardV balance. ### What happens if my CardV balance is too low? Checkout for gift cards is paused until your balance covers the cart, so customers are not charged for cards you cannot deliver. ### Which orders are delivered automatically? Only orders paid with the payment methods you select, and that pass your delivery rules. Everything else waits on **CardV > Orders** for you to approve or reject. ### Can I change product titles, descriptions and images? Yes. The sync updates cost, price and availability only. It never overwrites your text, and never replaces images, brand logos or categories you set yourself. ### How are products put into categories? In **CardV > Settings > Product sync** choose “Use CardV categories” (default: each product goes into a store category named like its CardV category, created when missing) or “Use my own categories” (the plugin never changes categories; you pick one when importing). A product whose categories you changed is always left alone. ### How can my theme or another plugin read gift card data? Use `cardv_gc_get_product_data( $product )`. For a CardV gift card it returns an array with `kind` (fixed or range), `brand` (name, logo URL), `region` (code, name),` category`, `face_currency`, `denominations` (variation ID, face value, currency, text shown, price, availability; lowest first), `range` (min, max, step, lowest and highest price), `redemption` (HTML) and `terms_html`; for other products it returns null. `cardv_gc_get_range_price( $product, $amount )` returns the price of a custom amount. The same data is in the WooCommerce Store API product response under `extensions.cardv`. These names stay compatible in future versions; new keys may be added. Cost and margin are never included. ### Why can’t customers buy, and how do I find out? When a customer cannot buy a gift card (no API key, the Live mode agreement not accepted, or your CardV balance does not cover the cart), the customer sees “temporarily unavailable” and you see the exact reason at the top of your WordPress dashboard, WooCommerce and CardV screens. ### Can my theme change how the codes look? Yes. Copy any file from the plugin’s `templates` folder to `yourtheme/cardv-gift- cards/` and edit it. ### Do I need to edit wp-config.php? No. Paste your keys on the Settings page; they are stored encrypted. Advanced users can instead define `CARDV_GC_LIVE_KEY_ID`, `CARDV_GC_LIVE_SIGNING_SECRET` and `CARDV_GC_LIVE_WEBHOOK_SECRET`( and the same names with `SANDBOX`) in `wp-config.php`; values set there override the Settings page. By default secrets and codes are encrypted with your WordPress salts. To use a separate key, define `CARDV_GC_ENCRYPTION_KEY` (at least 32 characters) before saving keys, and list old keys in `CARDV_GC_PREVIOUS_KEYS` (comma separated) when you change it. ### What is removed when I delete the plugin? Settings, encrypted secrets, scheduled jobs and the activity log are removed. Your products and orders stay in WooCommerce. Delivered codes stay encrypted on the orders. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “CardV Gift Cards” is open source software. The following people have contributed to this plugin. Contributors * [ cardvnetservice ](https://profiles.wordpress.org/cardvnetservice/) [Translate “CardV Gift Cards” into your language.](https://translate.wordpress.org/projects/wp-plugins/cardv-gift-cards) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/cardv-gift-cards/), check out the [SVN repository](https://plugins.svn.wordpress.org/cardv-gift-cards/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/cardv-gift-cards/) by [RSS](https://plugins.trac.wordpress.org/log/cardv-gift-cards/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.1.0 * Amounts are listed from lowest to highest face value; each amount stores its face value and currency. * Custom-amount cards use the price range CardV lists; no extra price requests during sync. The price shown on the product page is the price in the cart. * Amounts CardV no longer offers are hidden from the shop (kept for past orders) and come back if CardV offers them again. * Products are filed under CardV categories (or your own, your choice in Settings) and WooCommerce brands. * Brand logos are added to WooCommerce brands; product images and brand logos are kept separate and updated when CardV changes them. * “How to redeem” keeps CardV’s line breaks and is refreshed weekly. * When customers cannot buy, the reason is shown to you in the admin. * New for themes and plugins: `cardv_gc_get_product_data()`, `cardv_gc_get_range_price()` and the Store API `extensions.cardv` data. * After updating, one background sync adds the new data to products you imported before. Prices, titles and your own changes are kept. #### 1.0.0 * First release. ## Meta * Version **1.1.0** * Last updated **21 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.5 or higher ** * Tested up to **7.1.3** * PHP version ** 7.4 or higher ** * Tags * [digital goods](https://wordpress.org/plugins/tags/digital-goods/)[gift cards](https://wordpress.org/plugins/tags/gift-cards/) [vouchers](https://wordpress.org/plugins/tags/vouchers/)[woocommerce](https://wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://wordpress.org/plugins/cardv-gift-cards/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/cardv-gift-cards/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/cardv-gift-cards/reviews/) ## Contributors * [ cardvnetservice ](https://profiles.wordpress.org/cardvnetservice/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/cardv-gift-cards/)