Woocommerce Gift Cards

1{
2  "schemaVersion": 1,
3  "plugin": "woocommerce-gift-cards",
4  "displayName": "WooCommerce Gift Cards",
5  "profileVersion": "2026-08",
6  "sourceOfTruth": "https://woocommerce.com/document/woocommerce-gift-cards/",
7  "distribution": "premium-or-unlisted",
8  "capabilities": [
9    "commerce.gift-cards"
10  ],
11  "detect": {
12    "pluginFileIds": [
13      "woocommerce-gift-cards/woocommerce-gift-cards.php"
14    ],
15    "routes": [
16      "/wc/v3/gift-cards"
17    ],
18    "assetPathSlugs": [
19      "woocommerce-gift-cards"
20    ]
21  },
22  "entities": [
23    {
24      "entity": "gift-card",
25      "channel": "plugin-rest",
26      "route": "/wc/v3/gift-cards",
27      "recordKeyField": "id",
28      "candidateTargetRefs": [
29        "gift-cards/gift-card"
30      ],
31      "pitfalls": [
32        {
33          "code": "outstanding-balance-is-a-liability",
34          "severity": "blocker",
35          "summary": "Unspent gift card balances are money owed to customers. Reconcile the total outstanding value before and after import and show it in the execution plan; a silently dropped card is a lost customer entitlement."
36        },
37        {
38          "code": "code-length-may-not-fit-wix",
39          "severity": "blocker",
40          "summary": "Wix gift card codes must be 8-20 characters. Report any source code outside that range before import instead of rewriting it, because customers already hold the printed or emailed code."
41        },
42        {
43          "code": "partial-balance-policy-required",
44          "severity": "warning",
45          "summary": "Wix derives balance from transactions and only accepts an initial value, so a partly-redeemed card needs an explicit policy: import at remaining balance, or at face value with the spend replayed."
46        }
47      ]
48    }
49  ],
50  "excludeRoutes": [
51    {
52      "route": "/wc/v3/gift-cards/settings",
53      "reason": "plugin configuration, not gift card records"
54    }
55  ],
56  "quirks": [
57    "The plugin exposes gift cards under wc/v3; the route was observed live on a production store (2026-07-30).",
58    "Redemption history is per-card activity on the source but has no public Wix write surface, so it is reportable loss rather than migratable data."
59  ]
60}