CardV Gift Cards
| 开发者 | cardvnetservice |
|---|---|
| 更新时间 | 2026年10月20日 22:12 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- 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.
- A WooCommerce store.
- An approved CardV merchant account with API keys. Apply at cardv.net.
- A prepaid CardV balance. Orders are paid from this balance.
安装:
- Install and activate WooCommerce.
- Install this plugin from Plugins > Add New, or upload the zip, then activate it.
- Open CardV > Settings, choose Sandbox, paste your API key ID, signing secret and webhook secret, and save. The plugin tests the connection.
- Copy the webhook URL shown on the Settings page into your CardV Portal.
- Open CardV > Products, select the cards you want to sell and import them.
- Review your price and delivery rules, then switch to Live when you are ready.
屏幕截图:
常见问题:
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.
更新日志:
- 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 APIextensions.cardvdata. - After updating, one background sync adds the new data to products you imported before. Prices, titles and your own changes are kept.
- First release.