Domain

1{
2  "schemaVersion": 1,
3  "domain": "gift-cards",
4  "docsRoots": [
5    "api-reference/business-solutions/gift-cards"
6  ],
7  "displayName": "Wix Gift Cards",
8  "ownerHint": "Gift cards, stored value, and store credit domain owners",
9  "wixAppsRequired": [
10    "Wix Gift Card"
11  ],
12  "defaultImportOrder": [
13    "gift-card-product",
14    "gift-card"
15  ],
16  "sharedPitfalls": [
17    {
18      "code": "gift-card-app-required",
19      "severity": "blocker",
20      "summary": "The Wix Gift Card app must be installed before any gift-card write; verify during setup rather than discovering it at import time. appDefId d80111c5-a0f4-47a8-b63a-65b54d774a27 (per dev.wix.com's 'About Apps Created by Wix' table — DO NOT reuse an example id from other docs, e.g. Wix eCommerce's 1380b703-… is a real, easy-to-confuse-with-the-right-one dependency it pulls in). VERIFIED LIVE 2026-08-17: a site with no gift-card app installed fails create with `428 RISE_ACCOUNT_DOES_NOT_EXIST_FOR_META_SITE`, not an auth or validation error — install via the standard App Installation API (`POST /apps-installer-service/v1/app-instance/install`, body `{ appInstance: { appDefId, enabled: true }, tenant: { tenantType: \"SITE\", id: <siteId> }, installType: \"INSTALL_TYPE_SITE\", appsInstallOptions: {} }`), then retry."
21    },
22    {
23      "code": "distinguish-gift-card-surfaces",
24      "severity": "warning",
25      "summary": "Two Wix gift-card surfaces exist. `gift-cards/v1` creates and manages cards. The eCommerce payments gift-card surface only gets/redeems/voids cards issued by an external provider and is NOT an import path."
26    },
27    {
28      "code": "gifted-app-is-unrelated-third-party",
29      "severity": "warning",
30      "summary": "\"Gifted\" is a separate THIRD-PARTY app in the App Market, unrelated to the native \"Wix Gift Cards\" app this domain targets. Gifted stopped supporting new-card issuance on 2026-07-31 (existing cards still work) — that deprecation notice is easy to find while researching this domain and is NOT about the native gift-cards/v1 API, which is unaffected. Do not let a Gifted-app finding get attributed to this domain."
31    }
32  ],
33  "evidence": [
34    {
35      "type": "wix-docs",
36      "url": "https://dev.wix.com/docs/api-reference/business-solutions/gift-cards/gift-cards/introduction"
37    },
38    {
39      "type": "wix-docs",
40      "url": "https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/platform/about-apps-created-by-wix",
41      "note": "source of the appDefId above"
42    },
43    {
44      "type": "support-article",
45      "url": "https://support.wix.com/en/article/offering-gift-cards-with-the-gifted-app",
46      "note": "source of the Gifted-app deprecation notice and its third-party status"
47    }
48  ]
49}