Attributes:
serialNumber (str): The serial number of the customer pass
passTypeIdentifier (str): The pass type identifier of the customer pass
url (str): The shareable URL of the customer pass
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LoyaltyDog","description":"Developer documentation for the LoyaltyDog loyalty, gift card, and wallet pass platform.","colors":{"primary":"#E02040","light":"#FF4D6A","dark":"#A00C24"},"logo":{"light":"https://mintcdn.com/loyaltydog/nTgeGLHuJsYgNjQM/logo/logofull.png?fit=max\u0026auto=format\u0026n=nTgeGLHuJsYgNjQM\u0026q=85\u0026s=5a49eb0f121927ffebb8c5e5e8cbdd13","dark":"https://mintcdn.com/loyaltydog/nTgeGLHuJsYgNjQM/logo/logofull.png?fit=max\u0026auto=format\u0026n=nTgeGLHuJsYgNjQM\u0026q=85\u0026s=5a49eb0f121927ffebb8c5e5e8cbdd13","href":"https://loyalty.dog"},"favicon":"https://mintcdn.com/loyaltydog/nTgeGLHuJsYgNjQM/logo/logomark.png?fit=max\u0026auto=format\u0026n=nTgeGLHuJsYgNjQM\u0026q=85\u0026s=68cf1efecc80404347ea7d9668387bee","api":{"openapi":"openapi.public.json","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","javascript","python"],"autogenerate":true},"mdx":{"auth":{"method":"bearer"},"server":"https://api.loyalty.dog"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"},{"href":"https://loyalty.dog/support/","label":"Contact"}],"primary":{"type":"button","label":"Get an API key","href":"https://app.loyalty.dog/account/appkeys"}},"footer":{"socials":{"github":"https://github.com/loyaltydog","linkedin":"https://www.linkedin.com/company/loyaltydog"},"links":[{"header":"Product","items":[{"label":"Marketing site","href":"https://loyalty.dog"},{"label":"Pricing","href":"https://loyalty.dog/pricing"},{"label":"Contact","href":"https://loyalty.dog/support"}]},{"header":"Developers","items":[{"label":"API reference","href":"/api-reference"},{"label":"OpenAPI spec","href":"/resources/openapi"},{"label":"MCP server","href":"/mcp/overview"},{"label":"Status","href":"https://status.loyalty.dog"}]},{"header":"Legal","items":[{"label":"Terms of service","href":"https://loyalty.dog/loyalty-program-terms-of-service"},{"label":"Privacy policy","href":"https://loyalty.dog/privacy-policy"}]}]},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"API status","icon":"signal-bars","href":"https://status.loyalty.dog"},{"anchor":"Marketing site","icon":"globe","href":"https://loyalty.dog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/loyaltydog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"loyaltydog","hasAudioNarration":false,"actualSubdomain":"loyaltydog","customDomains":["docs.loyalty.dog"],"gitSource":{"type":"github","owner":"loyaltydog","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae64943426c3612a89990f1","collectionId":"4b677e8c-f46d-4675-a415-ecd1345fb237","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae64943426c3612a89990f1"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae64943426c3612a89990f1","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"API reference","count":206},{"language":"default","tag":"Loyalty","count":60},{"language":"default","tag":"Gift Cards","count":44},{"language":"default","tag":"Documentation","count":25},{"language":"default","tag":"fraud","count":12},{"language":"default","tag":"Passes","count":10},{"language":"default","tag":"Passes > Pass Images","count":9},{"language":"default","tag":"Integrations","count":8},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Pass Templates > Images","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/gift-cards/activategiftcard","slug":"/api-reference/gift-cards/activategiftcard","pageMetadata":{"title":"Activategiftcard","description":"### Activate Gift Card\n\nActivates a pending gift card and loads the initial balance. Creates an ACTIVATION transaction\nfor audit trail.\n\n**Business Rules**:\n- Only PENDING cards can be activated\n- Card must not be expired\n- Balance is set to initialValue upon activation\n- Status changes from PENDING to ACTIVE\n- Customer information can be updated during activation\n- Activation creates a transaction record\n- Authenticated customer session is required\n\n**Path Parameters**:\n- `programId`: MongoDB ObjectId of the loyalty program\n- `cardId`: MongoDB ObjectId of the gift card\n\n**Request Body**:\n- `customerEmail`: Customer email (optional, updates card if provided)\n- `customerName`: Customer name (optional, updates card if provided)\n\n**Returns**:\n- Activated gift card details with updated balance and ACTIVE status\n- Includes activatedAt timestamp\n\n**Status Codes**:\n- 200: Gift card activated successfully\n- 400: Card cannot be activated (already active, expired, or invalid status)\n- 404: Gift card not found or doesn't belong to program\n- 409: Activation conflicted with concurrent update\n- 401: Unauthorized\n\n**Idempotency Scope**:\n- Idempotency keys are scoped to `programId + activate + cardId`\n- The same key may be reused for different cards or different gift card actions","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/activate","href":"/api-reference/gift-cards/activategiftcard","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n h3: \"h3\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.h3, {\n children: \"Activate Gift Card\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Activates a pending gift card and loads the initial balance. Creates an ACTIVATION transaction\\nfor audit trail.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Business Rules\"\n }), \":\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Only PENDING cards can be activated\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Card must not be expired\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Balance is set to initialValue upon activation\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Status changes from PENDING to ACTIVE\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Customer information can be updated during activation\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Activation creates a transaction record\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Authenticated customer session is required\"\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Path Parameters\"\n }), \":\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"programId\"\n }), \": MongoDB ObjectId of the loyalty program\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"cardId\"\n }), \": MongoDB ObjectId of the gift card\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Request Body\"\n }), \":\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"customerEmail\"\n }), \": Customer email (optional, updates card if provided)\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"customerName\"\n }), \": Customer name (optional, updates card if provided)\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Returns\"\n }), \":\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Activated gift card details with updated balance and ACTIVE status\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Includes activatedAt timestamp\"\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Status Codes\"\n }), \":\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"200: Gift card activated successfully\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"400: Card cannot be activated (already active, expired, or invalid status)\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"404: Gift card not found or doesn’t belong to program\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"409: Activation conflicted with concurrent update\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"401: Unauthorized\"\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Idempotency Scope\"\n }), \":\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"Idempotency keys are scoped to \", _jsx(_components.code, {\n children: \"programId + activate + cardId\"\n })]\n }), \"\\n\", _jsx(_components.li, {\n children: \"The same key may be reused for different cards or different gift card actions\"\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Activategiftcard","description":"### Activate Gift Card\n\nActivates a pending gift card and loads the initial balance. Creates an ACTIVATION transaction\nfor audit trail.\n\n**Business Rules**:\n- Only PENDING cards can be activated\n- Card must not be expired\n- Balance is set to initialValue upon activation\n- Status changes from PENDING to ACTIVE\n- Customer information can be updated during activation\n- Activation creates a transaction record\n- Authenticated customer session is required\n\n**Path Parameters**:\n- `programId`: MongoDB ObjectId of the loyalty program\n- `cardId`: MongoDB ObjectId of the gift card\n\n**Request Body**:\n- `customerEmail`: Customer email (optional, updates card if provided)\n- `customerName`: Customer name (optional, updates card if provided)\n\n**Returns**:\n- Activated gift card details with updated balance and ACTIVE status\n- Includes activatedAt timestamp\n\n**Status Codes**:\n- 200: Gift card activated successfully\n- 400: Card cannot be activated (already active, expired, or invalid status)\n- 404: Gift card not found or doesn't belong to program\n- 409: Activation conflicted with concurrent update\n- 401: Unauthorized\n\n**Idempotency Scope**:\n- Idempotency keys are scoped to `programId + activate + cardId`\n- The same key may be reused for different cards or different gift card actions","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/activate","href":"/api-reference/gift-cards/activategiftcard","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Gift Cards"],"summary":"Activategiftcard","description":"### Activate Gift Card\n\nActivates a pending gift card and loads the initial balance. Creates an ACTIVATION transaction\nfor audit trail.\n\n**Business Rules**:\n- Only PENDING cards can be activated\n- Card must not be expired\n- Balance is set to initialValue upon activation\n- Status changes from PENDING to ACTIVE\n- Customer information can be updated during activation\n- Activation creates a transaction record\n- Authenticated customer session is required\n\n**Path Parameters**:\n- `programId`: MongoDB ObjectId of the loyalty program\n- `cardId`: MongoDB ObjectId of the gift card\n\n**Request Body**:\n- `customerEmail`: Customer email (optional, updates card if provided)\n- `customerName`: Customer name (optional, updates card if provided)\n\n**Returns**:\n- Activated gift card details with updated balance and ACTIVE status\n- Includes activatedAt timestamp\n\n**Status Codes**:\n- 200: Gift card activated successfully\n- 400: Card cannot be activated (already active, expired, or invalid status)\n- 404: Gift card not found or doesn't belong to program\n- 409: Activation conflicted with concurrent update\n- 401: Unauthorized\n\n**Idempotency Scope**:\n- Idempotency keys are scoped to `programId + activate + cardId`\n- The same key may be reused for different cards or different gift card actions","operationId":"activateGiftCard_v2_giftcards_programs__programId__cards__cardId__activate_post","parameters":["b39bdbb5-f201-46ae-b36a-68e994366032","1a2d6fbe-7b05-4d88-8c14-e158ab82ae44","a2973334-74c4-4987-b820-7c948b56b259","d8c4bba4-bca9-43f2-8b82-247d5d6454ba","4aae02f2-4869-4875-89c6-cad99f01ad0b"],"requestBody":"6cbae592-fc79-4be4-bdc8-d75512f1c861","responses":{"200":"6e11e85e-124d-4bfa-aace-f5ec560bf47b","422":"6b5366da-b188-4206-a013-d498ec8a1531"},"method":"post","type":"path","servers":["04253eb3-3981-4867-a43d-ac0adc7fd228"],"security":["db297e5b-586a-488a-a8b3-297bcc1b1bc5"],"path":"/v2/giftcards/programs/{programId}/cards/{cardId}/activate","baseUrlOptions":["https://api.loyalty.dog"],"title":"Activategiftcard","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b39bdbb5-f201-46ae-b36a-68e994366032":{"name":"programId","in":"path","required":true,"schema":{"oneOf":[{"type":"string","title":"Programid","maxLength":24,"minLength":24,"pattern":"^[0-9a-f]{24}$","example":"5eb7cf5a86d9755df3a6c593","isRequired":true,"uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Programid","isRequired":true,"uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"","typeLabel":"string | null"}},"1a2d6fbe-7b05-4d88-8c14-e158ab82ae44":{"name":"cardId","in":"path","required":true,"schema":{"oneOf":[{"type":"string","title":"Cardid","maxLength":24,"minLength":24,"pattern":"^[0-9a-f]{24}$","example":"5eb7cf5a86d9755df3a6c593","isRequired":true,"uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Cardid","isRequired":true,"uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"","typeLabel":"string | null"}},"a2973334-74c4-4987-b820-7c948b56b259":{"name":"idempotency-key","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"Idempotency-Key","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency-Key","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}},"d8c4bba4-bca9-43f2-8b82-247d5d6454ba":{"name":"X-Eposn-Customer-Token","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"X-Eposn-Customer-Token","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"X-Eposn-Customer-Token","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}},"4aae02f2-4869-4875-89c6-cad99f01ad0b":{"name":"X-Eposn-Merchant-Token","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"X-Eposn-Merchant-Token","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"X-Eposn-Merchant-Token","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"customerEmail":{"oneOf":[{"type":"string","title":"Customeremail","format":"email","uniqueKey":"customerEmail.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","title":"Customeremail","uniqueKey":"customerEmail.oneOf.1","typeLabel":"null"}],"uniqueKey":"customerEmail","typeLabel":"string\u003cemail> | null"},"customerPhone":{"oneOf":[{"type":"string","title":"Customerphone","maxLength":50,"uniqueKey":"customerPhone.oneOf.0","typeLabel":"string"},{"type":"null","title":"Customerphone","uniqueKey":"customerPhone.oneOf.1","typeLabel":"null"}],"uniqueKey":"customerPhone","typeLabel":"string | null"},"customerName":{"oneOf":[{"type":"string","title":"Customername","maxLength":255,"uniqueKey":"customerName.oneOf.0","typeLabel":"string"},{"type":"null","title":"Customername","uniqueKey":"customerName.oneOf.1","typeLabel":"null"}],"uniqueKey":"customerName","typeLabel":"string | null"},"securityCode":{"oneOf":[{"type":"string","title":"Securitycode","description":"Security code required for customer self-activation","maxLength":6,"uniqueKey":"securityCode.oneOf.0","typeLabel":"string"},{"type":"null","title":"Securitycode","description":"Security code required for customer self-activation","uniqueKey":"securityCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"securityCode","typeLabel":"string | null"}},"type":"object","title":"ActivateGiftCardRequest","uniqueKey":"","typeLabel":"ActivateGiftCardRequest · object"},"examples":{"Example":{"title":"Example","value":{"customerEmail":"[email protected]","customerPhone":"\u003cstring>","customerName":"\u003cstring>","securityCode":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6e11e85e-124d-4bfa-aace-f5ec560bf47b":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","maxLength":24,"minLength":24,"pattern":"^[0-9a-f]{24}$","example":"5eb7cf5a86d9755df3a6c593","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"cardNumber":{"type":"string","title":"Cardnumber","isRequired":true,"uniqueKey":"cardNumber","typeLabel":"string"},"balance":{"type":"string","title":"Balance","isRequired":true,"uniqueKey":"balance","typeLabel":"string"},"initialValue":{"type":"string","title":"Initialvalue","isRequired":true,"uniqueKey":"initialValue","typeLabel":"string"},"status":{"type":"string","enum":["pending","active","suspended","expired","voided","depleted"],"title":"GiftCardStatus","description":"Gift card status enumeration.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","format":"date-time","title":"Createdat","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"oneOf":[{"type":"string","title":"Updatedat","format":"date-time","isRequired":true,"uniqueKey":"updatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Updatedat","isRequired":true,"uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time> | null"},"activatedAt":{"oneOf":[{"type":"string","title":"Activatedat","format":"date-time","isRequired":true,"uniqueKey":"activatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Activatedat","isRequired":true,"uniqueKey":"activatedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"activatedAt","typeLabel":"string\u003cdate-time> | null"},"expiresAt":{"type":"string","format":"date-time","title":"Expiresat","isRequired":true,"uniqueKey":"expiresAt","typeLabel":"string\u003cdate-time>"},"suspendedReason":{"oneOf":[{"type":"string","title":"Suspendedreason","isRequired":true,"uniqueKey":"suspendedReason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Suspendedreason","isRequired":true,"uniqueKey":"suspendedReason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suspendedReason","typeLabel":"string | null"},"suspendedUntil":{"oneOf":[{"type":"string","title":"Suspendeduntil","format":"date-time","isRequired":true,"uniqueKey":"suspendedUntil.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Suspendeduntil","isRequired":true,"uniqueKey":"suspendedUntil.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suspendedUntil","typeLabel":"string\u003cdate-time> | null"},"suspendedAt":{"oneOf":[{"type":"string","title":"Suspendedat","format":"date-time","isRequired":true,"uniqueKey":"suspendedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Suspendedat","isRequired":true,"uniqueKey":"suspendedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suspendedAt","typeLabel":"string\u003cdate-time> | null"},"customerId":{"oneOf":[{"type":"string","maxLength":24,"minLength":24,"pattern":"^[0-9a-f]{24}$","example":"5eb7cf5a86d9755df3a6c593","isRequired":true,"uniqueKey":"customerId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"customerId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customerId","typeLabel":"string | null"},"customerEmail":{"oneOf":[{"type":"string","title":"Customeremail","isRequired":true,"uniqueKey":"customerEmail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Customeremail","isRequired":true,"uniqueKey":"customerEmail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customerEmail","typeLabel":"string | null"},"customerPhone":{"oneOf":[{"type":"string","title":"Customerphone","isRequired":true,"uniqueKey":"customerPhone.oneOf.0","typeLabel":"string"},{"type":"null","title":"Customerphone","isRequired":true,"uniqueKey":"customerPhone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customerPhone","typeLabel":"string | null"},"customerName":{"oneOf":[{"type":"string","title":"Customername","isRequired":true,"uniqueKey":"customerName.oneOf.0","typeLabel":"string"},{"type":"null","title":"Customername","isRequired":true,"uniqueKey":"customerName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customerName","typeLabel":"string | null"},"merchantId":{"type":"string","maxLength":24,"minLength":24,"pattern":"^[0-9a-f]{24}$","example":"5eb7cf5a86d9755df3a6c593","isRequired":true,"uniqueKey":"merchantId","typeLabel":"string"},"isPhysical":{"type":"boolean","title":"Isphysical","isRequired":true,"uniqueKey":"isPhysical","typeLabel":"boolean"},"designTemplate":{"oneOf":[{"type":"string","title":"Designtemplate","isRequired":true,"uniqueKey":"designTemplate.oneOf.0","typeLabel":"string"},{"type":"null","title":"Designtemplate","isRequired":true,"uniqueKey":"designTemplate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"designTemplate","typeLabel":"string | null"},"customMessage":{"oneOf":[{"type":"string","title":"Custommessage","isRequired":true,"uniqueKey":"customMessage.oneOf.0","typeLabel":"string"},{"type":"null","title":"Custommessage","isRequired":true,"uniqueKey":"customMessage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customMessage","typeLabel":"string | null"},"lastFourDigits":{"type":"string","title":"Lastfourdigits","isRequired":true,"uniqueKey":"lastFourDigits","typeLabel":"string"},"programId":{"type":"string","maxLength":24,"minLength":24,"pattern":"^[0-9a-f]{24}$","example":"5eb7cf5a86d9755df3a6c593","isRequired":true,"uniqueKey":"programId","typeLabel":"string"},"card":{"oneOf":[{"type":"object","title":"PassCard","description":"The customer card object\n\nAttributes:\n serialNumber (str): The serial number of the customer pass\n passTypeIdentifier (str): The pass type identifier of the customer pass\n url (str): The shareable URL of the customer pass","required":["serialNumber","passTypeIdentifier","url"],"properties":{"serialNumber":{"type":"string","title":"Serialnumber","isRequired":true,"uniqueKey":"card.oneOf.0.serialNumber","typeLabel":"string"},"passTypeIdentifier":{"type":"string","title":"Passtypeidentifier","isRequired":true,"uniqueKey":"card.oneOf.0.passTypeIdentifier","typeLabel":"string"},"url":{"type":"string","minLength":1,"format":"uri","title":"Url","isRequired":true,"uniqueKey":"card.oneOf.0.url","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"card.oneOf.0","typeLabel":"PassCard · object"},{"type":"null","isRequired":true,"uniqueKey":"card.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"card","typeLabel":"PassCard · object | null"},"senderName":{"oneOf":[{"type":"string","title":"Sendername","uniqueKey":"senderName.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sendername","uniqueKey":"senderName.oneOf.1","typeLabel":"null"}],"uniqueKey":"senderName","typeLabel":"string | null"},"merchantName":{"oneOf":[{"type":"string","title":"Merchantname","uniqueKey":"merchantName.oneOf.0","typeLabel":"string"},{"type":"null","title":"Merchantname","uniqueKey":"merchantName.oneOf.1","typeLabel":"null"}],"uniqueKey":"merchantName","typeLabel":"string | null"},"deliverAt":{"oneOf":[{"type":"string","title":"Deliverat","format":"date-time","uniqueKey":"deliverAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Deliverat","uniqueKey":"deliverAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"deliverAt","typeLabel":"string\u003cdate-time> | null"},"delivered":{"type":"boolean","title":"Delivered","default":false,"uniqueKey":"delivered","typeLabel":"boolean"}},"type":"object","required":["id","cardNumber","balance","initialValue","status","createdAt","updatedAt","activatedAt","expiresAt","suspendedReason","suspendedUntil","suspendedAt","customerId","customerEmail","customerPhone","customerName","merchantId","isPhysical","designTemplate","customMessage","lastFourDigits","programId","card"],"title":"GiftCardResponse","uniqueKey":"","typeLabel":"GiftCardResponse · object"},"examples":{"Example":{"title":"Example","value":{"id":"5eb7cf5a86d9755df3a6c593","cardNumber":"\u003cstring>","balance":"\u003cstring>","initialValue":"\u003cstring>","status":"pending","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","activatedAt":"2023-11-07T05:31:56Z","expiresAt":"2023-11-07T05:31:56Z","suspendedReason":"\u003cstring>","suspendedUntil":"2023-11-07T05:31:56Z","suspendedAt":"2023-11-07T05:31:56Z","customerId":"5eb7cf5a86d9755df3a6c593","customerEmail":"\u003cstring>","customerPhone":"\u003cstring>","customerName":"\u003cstring>","merchantId":"5eb7cf5a86d9755df3a6c593","isPhysical":true,"designTemplate":"\u003cstring>","customMessage":"\u003cstring>","lastFourDigits":"\u003cstring>","programId":"5eb7cf5a86d9755df3a6c593","card":{"serialNumber":"\u003cstring>","passTypeIdentifier":"\u003cstring>","url":"\u003cstring>"},"senderName":"\u003cstring>","merchantName":"\u003cstring>","deliverAt":"2023-11-07T05:31:56Z","delivered":false}}},"exampleType":"generated"}},"exampleType":"generated"},"6b5366da-b188-4206-a013-d498ec8a1531":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"db297e5b-586a-488a-a8b3-297bcc1b1bc5":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT access token obtained from POST /v2/token.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"04253eb3-3981-4867-a43d-ac0adc7fd228":{"url":"https://api.loyalty.dog","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT access token obtained from POST /v2/token.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"JWT access token obtained from POST /v2/token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.public.json"},"subdomain":"loyaltydog","siteName":"LoyaltyDog","title":"Activategiftcard - LoyaltyDog","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-10T17:19:02.544Z","originalFileLocation":"api-reference/gift-cards/activategiftcard.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"### Activate Gift Card Activates a pending gift card and loads the initial balance. Creates an ACTIVATION transaction for audit trail. Business Rules: - Only PENDING cards can be activated - Card must not be expired - Balance is set to initialValue upon activation - Status changes from PENDING to ACTIVE - Customer information can be updated during activation - Activation creates a transaction record - Authenticated customer session is required Path Parameters: - programId: MongoDB ObjectId of the loyalty program - cardId: MongoDB ObjectId of the gift card Request Body: - customerEmail: Customer email (optional, updates card if provided) - customerName: Customer name (optional, updates card if provided) Returns: - Activated gift card details with updated balance and ACTIVE status - Includes activatedAt timestamp Status Codes: - 200: Gift card activated successfully - 400: Card cannot be activated (already active, expired, or invalid status) - 404: Gift card not found or doesn\u0026#x27;t belong to program - 409: Activation conflicted with concurrent update - 401: Unauthorized Idempotency Scope: - Idempotency keys are scoped to programId + activate + cardId - The same key may be reused for different cards or different gift card actions\">\u003cmeta data-mint-head name=\"application-name\" content=\"LoyaltyDog\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Activategiftcard - LoyaltyDog\">\u003cmeta data-mint-head property=\"og:description\" content=\"### Activate Gift Card Activates a pending gift card and loads the initial balance. Creates an ACTIVATION transaction for audit trail. Business Rules: - Only PENDING cards can be activated - Card must not be expired - Balance is set to initialValue upon activation - Status changes from PENDING to ACTIVE - Customer information can be updated during activation - Activation creates a transaction record - Authenticated customer session is required Path Parameters: - programId: MongoDB ObjectId of the loyalty program - cardId: MongoDB ObjectId of the gift card Request Body: - customerEmail: Customer email (optional, updates card if provided) - customerName: Customer name (optional, updates card if provided) Returns: - Activated gift card details with updated balance and ACTIVE status - Includes activatedAt timestamp Status Codes: - 200: Gift card activated successfully - 400: Card cannot be activated (already active, expired, or invalid status) - 404: Gift card not found or doesn\u0026#x27;t belong to program - 409: Activation conflicted with concurrent update - 401: Unauthorized Idempotency Scope: - Idempotency keys are scoped to programId + activate + cardId - The same key may be reused for different cards or different gift card actions\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LoyaltyDog\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://loyaltydog.mintlify.app/_mintlify/api/og/v2?division=Gift+Cards\u0026amp;title=Activategiftcard\u0026amp;description=%23%23%23+Activate+Gift+Card%0A%0AActivates+a+pending+gift+card+and+loads+the+initial+balance.+Creates+an+ACTIVATION+transaction%0Afor+audit+trail.%0A%0A**Business+Rules**%3A%0A-+O\u0026amp;theme=f938ddbe6f2a962c0952e794\u0026amp;signature=e6a89dbeabc6e6c7d57c267674acda7d01a358872c20745f86cf996316650e84\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Activategiftcard - LoyaltyDog\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"### Activate Gift Card Activates a pending gift card and loads the initial balance. Creates an ACTIVATION transaction for audit trail. Business Rules: - Only PENDING cards can be activated - Card must not be expired - Balance is set to initialValue upon activation - Status changes from PENDING to ACTIVE - Customer information can be updated during activation - Activation creates a transaction record - Authenticated customer session is required Path Parameters: - programId: MongoDB ObjectId of the loyalty program - cardId: MongoDB ObjectId of the gift card Request Body: - customerEmail: Customer email (optional, updates card if provided) - customerName: Customer name (optional, updates card if provided) Returns: - Activated gift card details with updated balance and ACTIVE status - Includes activatedAt timestamp Status Codes: - 200: Gift card activated successfully - 400: Card cannot be activated (already active, expired, or invalid status) - 404: Gift card not found or doesn\u0026#x27;t belong to program - 409: Activation conflicted with concurrent update - 401: Unauthorized Idempotency Scope: - Idempotency keys are scoped to programId + activate + cardId - The same key may be reused for different cards or different gift card actions\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://loyaltydog.mintlify.app/_mintlify/api/og/v2?division=Gift+Cards\u0026amp;title=Activategiftcard\u0026amp;description=%23%23%23+Activate+Gift+Card%0A%0AActivates+a+pending+gift+card+and+loads+the+initial+balance.+Creates+an+ACTIVATION+transaction%0Afor+audit+trail.%0A%0A**Business+Rules**%3A%0A-+O\u0026amp;theme=f938ddbe6f2a962c0952e794\u0026amp;signature=e6a89dbeabc6e6c7d57c267674acda7d01a358872c20745f86cf996316650e84\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/loyaltydog/_pzTcBR0IkeVAmm7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LoyaltyDog\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E02040\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/gift-cards/activategiftcard.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.loyalty.dog/#organization\",\"name\":\"LoyaltyDog\",\"url\":\"https://docs.loyalty.dog\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/loyaltydog/nTgeGLHuJsYgNjQM/logo/logofull.png?fit=max\u0026auto=format\u0026n=nTgeGLHuJsYgNjQM\u0026q=85\u0026s=5a49eb0f121927ffebb8c5e5e8cbdd13\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.loyalty.dog#website\",\"name\":\"LoyaltyDog\",\"url\":\"https://docs.loyalty.dog\",\"publisher\":{\"@id\":\"https://docs.loyalty.dog/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard#webpage\",\"url\":\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard\",\"name\":\"Activategiftcard\",\"description\":\"### Activate Gift Card Activates a pending gift card and loads the initial balance. Creates an ACTIVATION transaction for audit trail. Business Rules: - Only PENDING cards can be activated - Card must not be expired - Balance is set to initialValue upon activation - Status changes from PENDING to ACTIVE - Customer information can be updated during activation - Activation creates a transaction record - Authenticated customer session is required Path Parameters: - programId: MongoDB ObjectId of the loyalty program - cardId: MongoDB ObjectId of the gift card Request Body: - customerEmail: Customer email (optional, updates card if provided) - customerName: Customer name (optional, updates card if provided) Returns: - Activated gift card details with updated balance and ACTIVE status - Includes activatedAt timestamp Status Codes: - 200: Gift card activated successfully - 400: Card cannot be activated (already active, expired, or invalid status) - 404: Gift card not found or doesn't belong to program - 409: Activation conflicted with concurrent update - 401: Unauthorized Idempotency Scope: - Idempotency keys are scoped to programId + activate + cardId - The same key may be reused for different cards or different gift card actions\",\"dateModified\":\"2026-10-10T17:19:02.544Z\",\"isPartOf\":{\"@id\":\"https://docs.loyalty.dog#website\"},\"breadcrumb\":{\"@id\":\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Gift Cards\",\"item\":\"https://docs.loyalty.dog/api-reference/gift-cards/giftcardhealthcheck\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Activategiftcard\",\"item\":\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard#apireference\",\"headline\":\"Activategiftcard\",\"name\":\"Activategiftcard\",\"description\":\"### Activate Gift Card Activates a pending gift card and loads the initial balance. Creates an ACTIVATION transaction for audit trail. Business Rules: - Only PENDING cards can be activated - Card must not be expired - Balance is set to initialValue upon activation - Status changes from PENDING to ACTIVE - Customer information can be updated during activation - Activation creates a transaction record - Authenticated customer session is required Path Parameters: - programId: MongoDB ObjectId of the loyalty program - cardId: MongoDB ObjectId of the gift card Request Body: - customerEmail: Customer email (optional, updates card if provided) - customerName: Customer name (optional, updates card if provided) Returns: - Activated gift card details with updated balance and ACTIVE status - Includes activatedAt timestamp Status Codes: - 200: Gift card activated successfully - 400: Card cannot be activated (already active, expired, or invalid status) - 404: Gift card not found or doesn't belong to program - 409: Activation conflicted with concurrent update - 401: Unauthorized Idempotency Scope: - Idempotency keys are scoped to programId + activate + cardId - The same key may be reused for different cards or different gift card actions\",\"url\":\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard\",\"mainEntityOfPage\":{\"@id\":\"https://docs.loyalty.dog/api-reference/gift-cards/activategiftcard#webpage\"},\"dateModified\":\"2026-10-10T17:19:02.544Z\",\"publisher\":{\"@id\":\"https://docs.loyalty.dog/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.loyalty.dog#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LoyaltyDog\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"LoyaltyDog","nav":{"global":{"anchors":[{"anchor":"API status","icon":"signal-bars","href":"https://status.loyalty.dog"},{"anchor":"Marketing site","icon":"globe","href":"https://loyalty.dog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/loyaltydog"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"group":"Token","pages":[{"title":"Get Token Info","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/token","href":"/api-reference/token/get-token-info"}]},{"group":"Loyalty","pages":[{"title":"Get Loyalty Programs","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs","href":"/api-reference/loyalty/get-loyalty-programs"},{"title":"Get Loyalty Program Details","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}","href":"/api-reference/loyalty/get-loyalty-program-details"},{"title":"Update Loyalty Program Details","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}","href":"/api-reference/loyalty/update-loyalty-program-details"},{"title":"Get Loyalty Program Custom Fields","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/customFields","href":"/api-reference/loyalty/get-loyalty-program-custom-fields"},{"title":"Update Loyalty Program Custom Fields","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}/customFields","href":"/api-reference/loyalty/update-loyalty-program-custom-fields"},{"title":"Get Loyalty Program Icon","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/icon","href":"/api-reference/loyalty/get-loyalty-program-icon"},{"title":"Update Loyalty Program Icon","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}/icon","href":"/api-reference/loyalty/update-loyalty-program-icon"},{"title":"Change Loyalty Program Pass Type","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}/passtype","href":"/api-reference/loyalty/change-loyalty-program-pass-type"},{"title":"Get Loyalty Program Card","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/card","href":"/api-reference/loyalty/get-loyalty-program-card"},{"title":"Update Loyalty Program Card","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}/card","href":"/api-reference/loyalty/update-loyalty-program-card"},{"title":"Get Loyalty Program Card Images","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/card/images","href":"/api-reference/loyalty/get-loyalty-program-card-images"},{"title":"Get Loyalty Program Card Image","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/card/images/{type}","href":"/api-reference/loyalty/get-loyalty-program-card-image"},{"title":"Update Loyalty Program Card Image","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/card/images/{type}","href":"/api-reference/loyalty/update-loyalty-program-card-image"},{"title":"Delete Loyalty Program Card Image","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/loyalty/programs/{programId}/card/images/{type}","href":"/api-reference/loyalty/delete-loyalty-program-card-image"},{"title":"Get Loyalty Program Offers","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/offers","href":"/api-reference/loyalty/get-loyalty-program-offers"},{"title":"Create Loyalty Program Offer","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/offers","href":"/api-reference/loyalty/create-loyalty-program-offer"},{"title":"Get Loyalty Program Offer","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/offers/{offerId}","href":"/api-reference/loyalty/get-loyalty-program-offer"},{"title":"Update Loyalty Program Offer","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}/offers/{offerId}","href":"/api-reference/loyalty/update-loyalty-program-offer"},{"title":"Delete Loyalty Program Offer","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/loyalty/programs/{programId}/offers/{offerId}","href":"/api-reference/loyalty/delete-loyalty-program-offer"},{"title":"Publish Loyalty Program Offer","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/offers/{offerId}/publish","href":"/api-reference/loyalty/publish-loyalty-program-offer"},{"title":"Cancel Loyalty Program Offer","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/offers/{offerId}/cancel","href":"/api-reference/loyalty/cancel-loyalty-program-offer"},{"title":"Duplicate Loyalty Program Offer","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/offers/{offerId}/duplicate","href":"/api-reference/loyalty/duplicate-loyalty-program-offer"},{"title":"Get Loyalty Program Offer Card","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/offers/{offerId}/card","href":"/api-reference/loyalty/get-loyalty-program-offer-card"},{"title":"Update Loyalty Program Offer Card","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}/offers/{offerId}/card","href":"/api-reference/loyalty/update-loyalty-program-offer-card"},{"title":"Get Loyalty Program Offer Images","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/offers/{offerId}/card/images","href":"/api-reference/loyalty/get-loyalty-program-offer-images"},{"title":"Get Loyalty Program Offer Card Image","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/offers/{offerId}/card/images/{type}","href":"/api-reference/loyalty/get-loyalty-program-offer-card-image"},{"title":"Create Or Update Loyalty Program Offer Card Image","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/offers/{offerId}/card/images/{type}","href":"/api-reference/loyalty/create-or-update-loyalty-program-offer-card-image"},{"title":"Delete Loyalty Program Offer Card Image","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/loyalty/programs/{programId}/offers/{offerId}/card/images/{type}","href":"/api-reference/loyalty/delete-loyalty-program-offer-card-image"},{"title":"List Loyalty Program Rules","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/rules","href":"/api-reference/loyalty/list-loyalty-program-rules"},{"title":"Get Loyalty Program Customers","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/customers","href":"/api-reference/loyalty/get-loyalty-program-customers"},{"title":"Create Loyalty Program Customer","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/customers","href":"/api-reference/loyalty/create-loyalty-program-customer"},{"title":"Get Loyalty Program Customer","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/customers/{customerId}","href":"/api-reference/loyalty/get-loyalty-program-customer"},{"title":"Update Loyalty Program Customer","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}/customers/{customerId}","href":"/api-reference/loyalty/update-loyalty-program-customer"},{"title":"Delete Loyalty Program Customer","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/loyalty/programs/{programId}/customers/{customerId}","href":"/api-reference/loyalty/delete-loyalty-program-customer"},{"title":"Get Loyalty Program Customer Reserved Points","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/customers/{customerId}/points/reserved","href":"/api-reference/loyalty/get-loyalty-program-customer-reserved-points"},{"title":"Post Loyalty Program Customer Push","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/customers/{customerId}/push","href":"/api-reference/loyalty/post-loyalty-program-customer-push"},{"title":"Update Loyalty Program Customer Points","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/customers/{customerId}/points/add","href":"/api-reference/loyalty/update-loyalty-program-customer-points"},{"title":"Get Loyalty Program Customer Offers","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/customers/{customerId}/offers","href":"/api-reference/loyalty/get-loyalty-program-customer-offers"},{"title":"Claim Loyalty Program Customer Offer","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/customers/{customerId}/offers/{offerId}/claim","href":"/api-reference/loyalty/claim-loyalty-program-customer-offer"},{"title":"Redeem Loyalty Program Customer Offer","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/customers/{customerId}/offers/current/redeem","href":"/api-reference/loyalty/redeem-loyalty-program-customer-offer"},{"title":"Get Loyalty Program Customer Activities","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/customers/{customerId}/activities","href":"/api-reference/loyalty/get-loyalty-program-customer-activities"},{"title":"Get Loyalty Program Customer Transactions","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/customers/{customerId}/transactions","href":"/api-reference/loyalty/get-loyalty-program-customer-transactions"},{"title":"Export Loyalty Program Customer Data","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/customers/{customerId}/export","href":"/api-reference/loyalty/export-loyalty-program-customer-data"},{"title":"Get Loyalty Program Activities","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/activities","href":"/api-reference/loyalty/get-loyalty-program-activities"},{"title":"Get Loyalty Program Transactions","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/transactions","href":"/api-reference/loyalty/get-loyalty-program-transactions"},{"title":"Create Loyalty Program Voucher","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/vouchers","href":"/api-reference/loyalty/create-loyalty-program-voucher"},{"title":"Get Loyalty Program Voucher","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/vouchers/{voucherId}","href":"/api-reference/loyalty/get-loyalty-program-voucher"},{"title":"Update Loyalty Program Voucher","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}/vouchers/{voucherId}","href":"/api-reference/loyalty/update-loyalty-program-voucher"},{"title":"Delete Loyalty Program Voucher","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/loyalty/programs/{programId}/vouchers/{voucherId}","href":"/api-reference/loyalty/delete-loyalty-program-voucher"},{"title":"Publish Loyalty Program Voucher","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/vouchers/{voucherId}/publish","href":"/api-reference/loyalty/publish-loyalty-program-voucher"},{"title":"Cancel Loyalty Program Voucher","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/vouchers/{voucherId}/cancel","href":"/api-reference/loyalty/cancel-loyalty-program-voucher"},{"title":"Publish Loyalty Program Voucher","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/vouchers/{voucherId}/issue","href":"/api-reference/loyalty/publish-loyalty-program-voucher-1"},{"title":"Get Loyalty Program Voucher Card","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/vouchers/{voucherId}/card","href":"/api-reference/loyalty/get-loyalty-program-voucher-card"},{"title":"Update Loyalty Program Voucher Card","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/loyalty/programs/{programId}/vouchers/{voucherId}/card","href":"/api-reference/loyalty/update-loyalty-program-voucher-card"},{"title":"Get Loyalty Program Voucher Images","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/vouchers/{voucherId}/card/images","href":"/api-reference/loyalty/get-loyalty-program-voucher-images"},{"title":"Get Loyalty Program Voucher Card Image","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/vouchers/{voucherId}/card/images/{type}","href":"/api-reference/loyalty/get-loyalty-program-voucher-card-image"},{"title":"Create Or Update Loyalty Program Voucher Card Image","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/vouchers/{voucherId}/card/images/{type}","href":"/api-reference/loyalty/create-or-update-loyalty-program-voucher-card-image"},{"title":"Delete Loyalty Program Voucher Card Image","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/loyalty/programs/{programId}/vouchers/{voucherId}/card/images/{type}","href":"/api-reference/loyalty/delete-loyalty-program-voucher-card-image"},{"title":"Get Customer Consents","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/loyalty/programs/{programId}/customers/{customerId}/consents","href":"/api-reference/loyalty/get-customer-consents"},{"title":"Record Customer Consents","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/loyalty/programs/{programId}/customers/{customerId}/consents","href":"/api-reference/loyalty/record-customer-consents"}]},{"group":"Gift Cards","pages":[{"title":"Giftcardhealthcheck","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/health","href":"/api-reference/gift-cards/giftcardhealthcheck"},{"title":"Getgiftcardbypasssid","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/passes/{passSid}","href":"/api-reference/gift-cards/getgiftcardbypasssid"},{"title":"Getgiftcards","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/cards","href":"/api-reference/gift-cards/getgiftcards"},{"title":"Creategiftcard","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards","href":"/api-reference/gift-cards/creategiftcard"},{"title":"Getgiftcards","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/cards","href":"/api-reference/gift-cards/getgiftcards-1"},{"title":"Searchgiftcards","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/search","href":"/api-reference/gift-cards/searchgiftcards"},{"title":"Searchgiftcards","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/search","href":"/api-reference/gift-cards/searchgiftcards-1"},{"title":"Look Up Gift Card Balance","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/cards/lookup","href":"/api-reference/gift-cards/look-up-gift-card-balance"},{"title":"Getgiftcarddetails","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/cards/{cardId}","href":"/api-reference/gift-cards/getgiftcarddetails"},{"title":"Schedulegiftcarddelivery","deprecated":null,"version":null,"openapi":"/openapi.public.json patch /v2/giftcards/programs/{programId}/cards/{cardId}/schedule","href":"/api-reference/gift-cards/schedulegiftcarddelivery"},{"title":"Resendgiftcardsecuritycode","description":"### Resend Security Code\n\nGenerates a new security code for the gift card and resends it via email or SMS.\nApplicable primarily to PENDING cards, allowing merchants to re-send the code if\nthe customer lost the email/SMS or needs a fresh code.","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/resend-code","href":"/api-reference/gift-cards/resendgiftcardsecuritycode"},{"title":"Activategiftcard","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/activate","href":"/api-reference/gift-cards/activategiftcard"},{"title":"Reloadgiftcard","description":"### Reload Gift Card\n\nAdds funds to an active gift card. Creates a RELOAD transaction for audit trail.\n\n**Business Rules**:\n- Only ACTIVE cards can be reloaded\n- Card must not be expired\n- Reload amount: $0.01 - $5,000 per transaction\n- Maximum card balance: $10,000\n- New balance = current balance + reload amount\n- Transaction includes before/after balance tracking\n\n**Path Parameters**:\n- `programId`: MongoDB ObjectId of the loyalty program\n- `cardId`: MongoDB ObjectId of the gift card\n\n**Request Body**:\n- `amount`: Amount to add ($0.01 - $5,000)\n- `referenceId`: External reference ID for tracking (optional)\n- `description`: Transaction description (optional, defaults to \"Gift card reload\")\n\n**Returns**:\n- Updated gift card details with new balance\n- Balance reflects immediately after reload\n\n**Status Codes**:\n- 200: Gift card reloaded successfully\n- 400: Cannot reload (inactive, expired, or would exceed max balance of $10,000)\n- 404: Gift card not found or doesn't belong to program\n- 401: Unauthorized\n\n**Error Response (Max Balance Exceeded)**:\n```json\n{\n \"detail\": \"Reload would exceed maximum card balance\",\n \"currentBalance\": 9500.00,\n \"reloadAmount\": 1000.00,\n \"maxBalance\": 10000.00,\n \"availableReloadAmount\": 500.00\n}\n```\n\n**Idempotency Scope**:\n- Idempotency keys are scoped to `programId + reload + cardId`\n- The same key may be reused for different cards or different gift card actions","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/reload","href":"/api-reference/gift-cards/reloadgiftcard"},{"title":"Reloadgiftcardbynumber","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/reload-by-number","href":"/api-reference/gift-cards/reloadgiftcardbynumber"},{"title":"Redeemgiftcard","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/redeem","href":"/api-reference/gift-cards/redeemgiftcard"},{"title":"Refundgiftcardtransaction","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/transactions/{transactionId}/refund","href":"/api-reference/gift-cards/refundgiftcardtransaction"},{"title":"Customercheckgiftcardbalance","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/customer/balance-check","href":"/api-reference/gift-cards/customercheckgiftcardbalance"},{"title":"Checkgiftcardbalance","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/balance-check","href":"/api-reference/gift-cards/checkgiftcardbalance"},{"title":"Consolidategiftcards","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/consolidate","href":"/api-reference/gift-cards/consolidategiftcards"},{"title":"Getgiftcardtransactions","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/cards/{cardId}/transactions","href":"/api-reference/gift-cards/getgiftcardtransactions"},{"title":"Transfergiftcardbalance","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/transfer","href":"/api-reference/gift-cards/transfergiftcardbalance"},{"title":"Transfergiftcardownership","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/transfer-ownership","href":"/api-reference/gift-cards/transfergiftcardownership"},{"title":"Getnetworkoverview","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/network/overview","href":"/api-reference/gift-cards/getnetworkoverview"},{"title":"Getbusinessreports","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/reports/business","href":"/api-reference/gift-cards/getbusinessreports"},{"title":"Getexpirationwarnings","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/reports/expiration-warnings","href":"/api-reference/gift-cards/getexpirationwarnings"},{"title":"Voidgiftcard","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/void","href":"/api-reference/gift-cards/voidgiftcard"},{"title":"Suspendgiftcard","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/suspend","href":"/api-reference/gift-cards/suspendgiftcard"},{"title":"Unsuspendgiftcard","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/unsuspend","href":"/api-reference/gift-cards/unsuspendgiftcard"},{"title":"Processexpiredcard","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/{cardId}/process-expired","href":"/api-reference/gift-cards/processexpiredcard"},{"title":"Getamlalerts","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/compliance/aml","href":"/api-reference/gift-cards/getamlalerts"},{"title":"Acknowledgeamlalert","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/compliance/aml/{alertId}/acknowledge","href":"/api-reference/gift-cards/acknowledgeamlalert"},{"title":"Exportgiftcardcustomerdata","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/gdpr/export","href":"/api-reference/gift-cards/exportgiftcardcustomerdata"},{"title":"Downloadgiftcardcustomerdata","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/gdpr/download","href":"/api-reference/gift-cards/downloadgiftcardcustomerdata"},{"title":"Erasegiftcardcustomerdata","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/gdpr/erasure","href":"/api-reference/gift-cards/erasegiftcardcustomerdata"},{"title":"Getgiftcardconsentbyidentifier","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/gdpr/consent/lookup","href":"/api-reference/gift-cards/getgiftcardconsentbyidentifier"},{"title":"Getgiftcardconsent","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/gdpr/consent/{customerId}","href":"/api-reference/gift-cards/getgiftcardconsent"},{"title":"Updategiftcardconsent","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/gdpr/consent/{customerId}","href":"/api-reference/gift-cards/updategiftcardconsent"},{"title":"Creategiftcardconsent","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/gdpr/consent","href":"/api-reference/gift-cards/creategiftcardconsent"},{"title":"Getescheatmentreport","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/reports/escheatment","href":"/api-reference/gift-cards/getescheatmentreport"},{"title":"Getcustomerreports","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/customer/reports","href":"/api-reference/gift-cards/getcustomerreports"},{"title":"Getcustomertransactions","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/customer/transactions","href":"/api-reference/gift-cards/getcustomertransactions"},{"title":"Getcustomerconsolidatablemerchants","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/customer/consolidatable-merchants","href":"/api-reference/gift-cards/getcustomerconsolidatablemerchants"},{"title":"Issue multiple gift cards","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/cards/bulk","href":"/api-reference/gift-cards/issue-multiple-gift-cards"},{"title":"Poll async bulk issuance task","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/cards/bulk/{taskId}","href":"/api-reference/gift-cards/poll-async-bulk-issuance-task"}]},{"group":"Gift Card Customers","pages":[{"title":"Sendcustomerotp","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/customers/otp/send","href":"/api-reference/gift-card-customers/sendcustomerotp"},{"title":"Verifycustomerotp","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/customers/otp/verify","href":"/api-reference/gift-card-customers/verifycustomerotp"},{"title":"Logoutcustomer","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/customers/logout","href":"/api-reference/gift-card-customers/logoutcustomer"},{"title":"Validatecustomersession","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/customers/session","href":"/api-reference/gift-card-customers/validatecustomersession"}]},{"group":"Gift Card Merchants","pages":[{"title":"Initmerchantsession","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/merchants/session","href":"/api-reference/gift-card-merchants/initmerchantsession"},{"title":"Validatemerchantsession","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/merchants/session/validate","href":"/api-reference/gift-card-merchants/validatemerchantsession"},{"title":"Savemerchantsettings","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/giftcards/merchants/settings","href":"/api-reference/gift-card-merchants/savemerchantsettings"},{"title":"Getmerchanttheme","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/merchants/theme","href":"/api-reference/gift-card-merchants/getmerchanttheme"},{"title":"Savemerchanttheme","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/giftcards/merchants/theme","href":"/api-reference/gift-card-merchants/savemerchanttheme"}]},{"group":"Audit Logs","pages":[{"title":"Query Audit Logs","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/audit-logs","href":"/api-reference/audit-logs/query-audit-logs"},{"title":"Export Audit Logs","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/audit-logs/export","href":"/api-reference/audit-logs/export-audit-logs"},{"title":"Get Export Status","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/audit-logs/export/{task_id}","href":"/api-reference/audit-logs/get-export-status"}]},{"group":"fraud","pages":[{"title":"Get Fraud Metrics","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/fraud/metrics","href":"/api-reference/fraud/get-fraud-metrics"},{"title":"Get Fraud Alerts","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/fraud/alerts","href":"/api-reference/fraud/get-fraud-alerts"},{"title":"Acknowledge Fraud Alert","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/fraud/alerts/{alert_id}/acknowledge","href":"/api-reference/fraud/acknowledge-fraud-alert"},{"title":"Get Fraud Patterns","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/fraud/patterns","href":"/api-reference/fraud/get-fraud-patterns"},{"title":"Get Blocked Ips","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/fraud/blocked-ips","href":"/api-reference/fraud/get-blocked-ips"},{"title":"Block Ip","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/fraud/block-ip","href":"/api-reference/fraud/block-ip"},{"title":"Unblock Ip","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/giftcards/programs/{programId}/fraud/block-ip/{ip}","href":"/api-reference/fraud/unblock-ip"},{"title":"Get Velocity Checks","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/fraud/velocity-checks","href":"/api-reference/fraud/get-velocity-checks"},{"title":"Get Fraud Rules","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/fraud/rules","href":"/api-reference/fraud/get-fraud-rules"},{"title":"Create Fraud Rule","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/fraud/rules","href":"/api-reference/fraud/create-fraud-rule"},{"title":"Update Fraud Rule","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/giftcards/programs/{programId}/fraud/rules/{rule_id}","href":"/api-reference/fraud/update-fraud-rule"},{"title":"Delete Fraud Rule","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/giftcards/programs/{programId}/fraud/rules/{rule_id}","href":"/api-reference/fraud/delete-fraud-rule"}]},{"group":"anomalies","pages":[{"title":"Get Anomaly Alerts","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/anomalies/alerts","href":"/api-reference/anomalies/get-anomaly-alerts"},{"title":"Get Anomaly Metrics","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/anomalies/metrics","href":"/api-reference/anomalies/get-anomaly-metrics"},{"title":"Acknowledge Anomaly Alert","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/anomalies/alerts/{alert_id}/acknowledge","href":"/api-reference/anomalies/acknowledge-anomaly-alert"}]},{"group":"Gift Card Analytics","pages":[{"title":"Get Analytics Overview","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/analytics/overview","href":"/api-reference/gift-card-analytics/get-analytics-overview"},{"title":"Get Analytics Trends","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/analytics/trends","href":"/api-reference/gift-card-analytics/get-analytics-trends"},{"title":"Export Analytics","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/analytics/export","href":"/api-reference/gift-card-analytics/export-analytics"}]},{"group":"Gift Card Reports","pages":[{"title":"Create Schedule","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/reports/schedule","href":"/api-reference/gift-card-reports/create-schedule"},{"title":"List Scheduled Reports","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/reports/scheduled","href":"/api-reference/gift-card-reports/list-scheduled-reports"},{"title":"Delete Scheduled Report","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/giftcards/programs/{programId}/reports/scheduled/{scheduleId}","href":"/api-reference/gift-card-reports/delete-scheduled-report"},{"title":"Download Scheduled Report","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/giftcards/programs/{programId}/reports/scheduled/{scheduleId}/download","href":"/api-reference/gift-card-reports/download-scheduled-report"},{"title":"Validate Report Data","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/giftcards/programs/{programId}/reports/validate","href":"/api-reference/gift-card-reports/validate-report-data"}]},{"group":"Pass Type IDs","pages":[{"title":"Get All Available Passtypes","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passtypes","href":"/api-reference/pass-type-ids/get-all-available-passtypes"},{"title":"Get Passtype Information","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passtypes/{passTypeIdentifier}","href":"/api-reference/pass-type-ids/get-passtype-information"}]},{"group":"Pass Templates","pages":[{"title":"Get Pass Templates","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates","href":"/api-reference/pass-templates/get-pass-templates"},{"title":"Create Pass Template","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/templates","href":"/api-reference/pass-templates/create-pass-template"}]},{"group":"Pass Templates > Information","pages":[{"title":"Get Pass Template Information","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}","href":"/api-reference/pass-templates->-information/get-pass-template-information"},{"title":"Update Pass Template Information","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/templates/{templateId}","href":"/api-reference/pass-templates->-information/update-pass-template-information"},{"title":"Delete Pass Template Information","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/templates/{templateId}","href":"/api-reference/pass-templates->-information/delete-pass-template-information"}]},{"group":"Templates","pages":[{"title":"Get Pass Json","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}/walletclass","href":"/api-reference/templates/get-pass-json"}]},{"group":"Pass Templates > Link","pages":[{"title":"Get Pass Template Link","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}/url","href":"/api-reference/pass-templates->-link/get-pass-template-link"}]},{"group":"Pass Templates > Pass Generation","pages":[{"title":"Create Pass From Template With Values Images","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/templates/{templateId}/pass","href":"/api-reference/pass-templates->-pass-generation/create-pass-from-template-with-values-images"},{"title":"Create Pass From Template With Values Images By Name","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/templates/names/{name}/pass","href":"/api-reference/pass-templates->-pass-generation/create-pass-from-template-with-values-images-by-name"}]},{"group":"Pass Templates > Images","pages":[{"title":"Get All Images Of Pass Template","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}/images","href":"/api-reference/pass-templates->-images/get-all-images-of-pass-template"},{"title":"Delete All Images Of Pass Template","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/templates/{templateId}/images","href":"/api-reference/pass-templates->-images/delete-all-images-of-pass-template"},{"title":"Get All Images Of Pass Template Of Type","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}/images/{type}","href":"/api-reference/pass-templates->-images/get-all-images-of-pass-template-of-type"},{"title":"Delete All Images Of Pass Template Of Type","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/templates/{templateId}/images/{type}","href":"/api-reference/pass-templates->-images/delete-all-images-of-pass-template-of-type"},{"title":"Get Image From Pass Template Of Type And Resolution","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}/images/{type}/{resolution}","href":"/api-reference/pass-templates->-images/get-image-from-pass-template-of-type-and-resolution"},{"title":"Create Or Update Image Of Pass Template Of Type And Resolution","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/templates/{templateId}/images/{type}/{resolution}","href":"/api-reference/pass-templates->-images/create-or-update-image-of-pass-template-of-type-and-resolution"},{"title":"Delete Image Of Pass Template Of Type And Resolution","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/templates/{templateId}/images/{type}/{resolution}","href":"/api-reference/pass-templates->-images/delete-image-of-pass-template-of-type-and-resolution"}]},{"group":"Pass Templates > Actions","pages":[{"title":"Get Pass Template Actions","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}/actions","href":"/api-reference/pass-templates->-actions/get-pass-template-actions"},{"title":"Update Pass Template Actions","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/templates/{templateId}/actions","href":"/api-reference/pass-templates->-actions/update-pass-template-actions"}]},{"group":"Pass Templates > Branding","pages":[{"title":"Get Branding Settings Of Pass Template","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}/branding","href":"/api-reference/pass-templates->-branding/get-branding-settings-of-pass-template"},{"title":"Update Branding Settings Of Pass Template","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/templates/{templateId}/branding","href":"/api-reference/pass-templates->-branding/update-branding-settings-of-pass-template"},{"title":"Update Branding Footer Image","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/templates/{templateId}/branding/footer","href":"/api-reference/pass-templates->-branding/update-branding-footer-image"},{"title":"Delete Branding Footer Image","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/templates/{templateId}/branding/footer","href":"/api-reference/pass-templates->-branding/delete-branding-footer-image"}]},{"group":"Pass Templates > Distribution Restrictions","pages":[{"title":"Get Pass Template Distribution Restrictions","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}/restrictions","href":"/api-reference/pass-templates->-distribution-restrictions/get-pass-template-distribution-restrictions"},{"title":"Update Pass Template Distribution Restrictions","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/templates/{templateId}/restrictions","href":"/api-reference/pass-templates->-distribution-restrictions/update-pass-template-distribution-restrictions"}]},{"group":"Pass Templates > Payment Settings","pages":[{"title":"Get Payment Settings For Pass Template","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/templates/{templateId}/payment","href":"/api-reference/pass-templates->-payment-settings/get-payment-settings-for-pass-template"}]},{"group":"Pass Templates > Payment","pages":[{"title":"Update Payment Settings For Pass Template","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/templates/{templateId}/payment","href":"/api-reference/pass-templates->-payment/update-payment-settings-for-pass-template"}]},{"group":"Passes","pages":[{"title":"Get Passes","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes","href":"/api-reference/passes/get-passes"},{"title":"Get Pass Type Identifier","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}","href":"/api-reference/passes/get-pass-type-identifier"},{"title":"Get Pass","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}","href":"/api-reference/passes/get-pass"},{"title":"Delete Pass","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/passes/{passTypeIdentifier}/{serialNumber}","href":"/api-reference/passes/delete-pass"},{"title":"Get Pass Url","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/url","href":"/api-reference/passes/get-pass-url"},{"title":"Get Pass Wallet Object","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/walletobject","href":"/api-reference/passes/get-pass-wallet-object"},{"title":"Get Save Pass To Wallet Url","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/savetowallet","href":"/api-reference/passes/get-save-pass-to-wallet-url"},{"title":"Get Pass Json","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/passjson","href":"/api-reference/passes/get-pass-json"},{"title":"Send Pass To Email","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/passes/{passTypeIdentifier}/{serialNumber}/email","href":"/api-reference/passes/send-pass-to-email"},{"title":"Push Update To Pass","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/passes/{passTypeIdentifier}/{serialNumber}/push","href":"/api-reference/passes/push-update-to-pass"}]},{"group":"Passes > Pass Values","pages":[{"title":"Get Pass Values","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/values","href":"/api-reference/passes->-pass-values/get-pass-values"},{"title":"Put Pass Values","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/passes/{passTypeIdentifier}/{serialNumber}/values","href":"/api-reference/passes->-pass-values/put-pass-values"},{"title":"Update Pass Placeholder","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/passes/{passTypeIdentifier}/{serialNumber}/values/{placeholderName}","href":"/api-reference/passes->-pass-values/update-pass-placeholder"}]},{"group":"Passes > Pass Images","pages":[{"title":"Get Pass Images","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/images","href":"/api-reference/passes->-pass-images/get-pass-images"},{"title":"Delete Pass Images","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/passes/{passTypeIdentifier}/{serialNumber}/images","href":"/api-reference/passes->-pass-images/delete-pass-images"},{"title":"Get Pass Images By Type","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/images/{type}","href":"/api-reference/passes->-pass-images/get-pass-images-by-type"},{"title":"Delete All Pass Images Type","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/passes/{passTypeIdentifier}/{serialNumber}/images/{type}","href":"/api-reference/passes->-pass-images/delete-all-pass-images-type"},{"title":"Get Pass Images Type Resolution","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/images/{type}/{resolution}","href":"/api-reference/passes->-pass-images/get-pass-images-type-resolution"},{"title":"Create Update Pass Images Type Resolution","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/passes/{passTypeIdentifier}/{serialNumber}/images/{type}/{resolution}","href":"/api-reference/passes->-pass-images/create-update-pass-images-type-resolution"},{"title":"Delete All Pass Images Type Resolution","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/passes/{passTypeIdentifier}/{serialNumber}/images/{type}/{resolution}","href":"/api-reference/passes->-pass-images/delete-all-pass-images-type-resolution"},{"title":"Get Pass Status","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/status","href":"/api-reference/passes->-pass-images/get-pass-status"},{"title":"Update Pass Status","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/passes/{passTypeIdentifier}/{serialNumber}/status","href":"/api-reference/passes->-pass-images/update-pass-status"}]},{"group":"Passes > Pass Payment","pages":[{"title":"Get Pass Price","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/passes/{passTypeIdentifier}/{serialNumber}/price","href":"/api-reference/passes->-pass-payment/get-pass-price"},{"title":"Update Custom Price","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/passes/{passTypeIdentifier}/{serialNumber}/price","href":"/api-reference/passes->-pass-payment/update-custom-price"},{"title":"Delete Custom Price","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/passes/{passTypeIdentifier}/{serialNumber}/price","href":"/api-reference/passes->-pass-payment/delete-custom-price"}]},{"group":"Scanners","pages":[{"title":"Get All Scanners","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/scanners","href":"/api-reference/scanners/get-all-scanners"},{"title":"Create Scanner","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/scanners","href":"/api-reference/scanners/create-scanner"},{"title":"Get Scanner Information","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/scanners/{scannerId}","href":"/api-reference/scanners/get-scanner-information"},{"title":"Update Scanner Information","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/scanners/{scannerId}","href":"/api-reference/scanners/update-scanner-information"},{"title":"Delete Scanner","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/scanners/{scannerId}","href":"/api-reference/scanners/delete-scanner"}]},{"group":"Webhooks","pages":[{"title":"Get All Webhooks","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/webhooks","href":"/api-reference/webhooks/get-all-webhooks"},{"title":"Create Webhook","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Get Webhook Information","deprecated":null,"version":null,"openapi":"/openapi.public.json get /v2/webhooks/{webhookId}","href":"/api-reference/webhooks/get-webhook-information"},{"title":"Update Webhook Information","deprecated":null,"version":null,"openapi":"/openapi.public.json put /v2/webhooks/{webhookId}","href":"/api-reference/webhooks/update-webhook-information"},{"title":"Delete Webhook","deprecated":null,"version":null,"openapi":"/openapi.public.json delete /v2/webhooks/{webhookId}","href":"/api-reference/webhooks/delete-webhook"},{"title":"Enable Webhook","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/webhooks/{webhookId}/enable","href":"/api-reference/webhooks/enable-webhook"},{"title":"Disable Webhook","deprecated":null,"version":null,"openapi":"/openapi.public.json post /v2/webhooks/{webhookId}/disable","href":"/api-reference/webhooks/disable-webhook"}]}]}]},"basePath":"","title":"Activategiftcard - LoyaltyDog","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}