A subscriber scans a QR Code or taps a link to go to a registration page for a digital card of an organization. When the form is filled and some checks are checked, the subscriber submits the form.Then;
1
BrandWallet creates a new Subscriber for the organization
2
A new Subscriber Card is also created
3
Subscriber Card is returned and added to the wallet
Register not Create
Registering a subscriber is different than creating a new record in DB. There may be add-on promotions configured to be triggered with this registration event.Also some WebHooks may be called with the new subscriber’s data.
After a Subscriber is created, you can now find this customer by searching with their barcode, phone number or email.When you successfully find the subscriber card you want to process, you can create a Transaction and send it to BrandWallet to process.
Last modified on August 14, 2026
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"BrandWallet","colors":{"primary":"#7e22ce","light":"#d7209a","dark":"#7e22ce"},"logo":{"light":"https://mintcdn.com/brandwallet/2BnWo2UIj-f62HjD/images/bw-logo.17cdp47.vbv0a.webp?fit=max\u0026auto=format\u0026n=2BnWo2UIj-f62HjD\u0026q=85\u0026s=67bfe9e45f9049ced17b75cf0a451d25","dark":"https://mintcdn.com/brandwallet/2BnWo2UIj-f62HjD/images/bw-logo-white.0u3zp1imbnt7s.webp?fit=max\u0026auto=format\u0026n=2BnWo2UIj-f62HjD\u0026q=85\u0026s=5cf4694a4f0f7fe280761eb9ca74fe07"},"favicon":"https://media.brand.dev/c4e90885-b6c5-4a41-898d-0cbc13d7bd38.png","api":{"params":{"expanded":"closed"},"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["typescript","javascript","c#",".NET"],"prefill":true,"autogenerate":true},"url":"full","mdx":{"auth":{"method":"bearer"}}},"background":{"decoration":"windows"},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://live.brand-wallet.com"}},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"icons":{"library":"tabler"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","download-pdf","claude","chatgpt"],"display":"toc"},"thumbnails":{"fonts":{"family":"Inter"}},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"markdown":{"schema":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"brandwallet","hasAudioNarration":false,"actualSubdomain":"brandwallet","customDomains":["docs.brand-wallet.com"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-brandwallet-f5289466","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6accc6102aacaee627be2fa4","collectionId":"57368395-aa71-4777-ba4f-eef31886e65c","liveDeploymentHistoryId":"6accc6102aacaee627be2fa4","schemaVersion":"v3"},"feedback":{"agentFeedback":true,"thumbs":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6accc6102aacaee627be2fa4","clientVersion":"0.0.4064","searchFilterCounts":[{"language":"default","tag":"API","count":37},{"language":"default","tag":"Endpoints","count":32},{"language":"default","tag":"User Guidelines","count":16},{"language":"default","tag":"Integrate with BrandWallet","count":11},{"language":"default","tag":"Customers","count":10},{"language":"default","tag":"Get Started","count":7},{"language":"default","tag":"Users","count":6},{"language":"default","tag":"Transactions","count":6},{"language":"default","tag":"FAQ","count":6},{"language":"default","tag":"Categories","count":5}]},"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":"rbac-expansion","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":"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":"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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"process/first-transaction","slug":"/process/first-transaction","pageMetadata":{"title":"Your First Transaction","sidebarTitle":"Your First Transaction","description":"Learn how to find a subscriber, load all of their data and send a transaction to be processes by BrandWallet.","href":"/process/first-transaction"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Learn how to find a subscriber, load all of their data and send a transaction to be processes by BrandWallet.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components},{Card,Heading,Step,Steps}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Card processing in BrandWallet starts with finding the subscriber.`}),`\n`,_jsx(_components.p,{children:`But before;`}),`\n`,_jsx(Heading,{level:`2`,id:`register-a-subscriber`,children:`Register a Subscriber`}),`\n`,_jsx(_components.p,{children:`A subscriber scans a QR Code or taps a link to go to a registration page for a digital card of an organization. When the form is filled and some checks are checked, the subscriber submits the form.`}),`\n`,_jsx(_components.p,{children:`Then;`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`BrandWallet creates a new Subscriber for the organization`,titleSize:`p`}),_jsx(Step,{title:`A new Subscriber Card is also created`}),_jsx(Step,{title:`Subscriber Card is returned and added to the wallet`})]}),`\n`,_jsxs(Card,{title:`Register not Create`,type:`warning`,children:[_jsx(_components.p,{children:`Registering a subscriber is different than creating a new record in DB. There may be add-on promotions configured to be triggered with this registration event.`}),_jsx(_components.p,{children:`Also some WebHooks may be called with the new subscriber’s data.`})]}),`\n`,_jsx(_components.p,{children:`After a Subscriber is created, you can now find this customer by searching with their barcode, phone number or email.`}),`\n`,_jsx(_components.p,{children:`When you successfully find the subscriber card you want to process, you can create a Transaction and send it to BrandWallet to process.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Your First Transaction","sidebarTitle":"Your First Transaction","description":"Learn how to find a subscriber, load all of their data and send a transaction to be processes by BrandWallet.","href":"/process/first-transaction"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Register a Subscriber","slug":"register-a-subscriber","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"brandwallet","siteName":"BrandWallet","title":"Your First Transaction - BrandWallet","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-14T09:57:29.233Z","gitLastModified":"2026-08-14T09:57:10.000Z","originalFileLocation":"process/first-transaction.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=\"Learn how to find a subscriber, load all of their data and send a transaction to be processes by BrandWallet.\">\u003cmeta data-mint-head name=\"application-name\" content=\"BrandWallet\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://media.brand.dev/c4e90885-b6c5-4a41-898d-0cbc13d7bd38.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://media.brand.dev/c4e90885-b6c5-4a41-898d-0cbc13d7bd38.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://media.brand.dev/c4e90885-b6c5-4a41-898d-0cbc13d7bd38.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://media.brand.dev/c4e90885-b6c5-4a41-898d-0cbc13d7bd38.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Your First Transaction - BrandWallet\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn how to find a subscriber, load all of their data and send a transaction to be processes by BrandWallet.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"BrandWallet\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.brand-wallet.com/process/first-transaction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://brandwallet.mintlify.app/_mintlify/api/og/v2?division=Process+a+Digital+Card\u0026amp;title=Your+First+Transaction\u0026amp;description=Learn+how+to+find+a+subscriber%2C+load+all+of+their+data+and+send+a+transaction+to+be+processes+by+BrandWallet.\u0026amp;theme=b4412f6ef4a486f1e8dca21b\u0026amp;signature=42c2a72de6aba5c05368c15f9723b9217b44170d4708e172e462e103c93389f9\">\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=\"Your First Transaction - BrandWallet\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn how to find a subscriber, load all of their data and send a transaction to be processes by BrandWallet.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://brandwallet.mintlify.app/_mintlify/api/og/v2?division=Process+a+Digital+Card\u0026amp;title=Your+First+Transaction\u0026amp;description=Learn+how+to+find+a+subscriber%2C+load+all+of+their+data+and+send+a+transaction+to+be+processes+by+BrandWallet.\u0026amp;theme=b4412f6ef4a486f1e8dca21b\u0026amp;signature=42c2a72de6aba5c05368c15f9723b9217b44170d4708e172e462e103c93389f9\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/brandwallet/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"BrandWallet\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7e22ce\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.brand-wallet.com/process/first-transaction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/process/first-transaction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.brand-wallet.com/#organization\",\"name\":\"BrandWallet\",\"url\":\"https://docs.brand-wallet.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/brandwallet/2BnWo2UIj-f62HjD/images/bw-logo.17cdp47.vbv0a.webp?fit=max\u0026auto=format\u0026n=2BnWo2UIj-f62HjD\u0026q=85\u0026s=67bfe9e45f9049ced17b75cf0a451d25\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.brand-wallet.com#website\",\"name\":\"BrandWallet\",\"url\":\"https://docs.brand-wallet.com\",\"publisher\":{\"@id\":\"https://docs.brand-wallet.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.brand-wallet.com/process/first-transaction#webpage\",\"url\":\"https://docs.brand-wallet.com/process/first-transaction\",\"name\":\"Your First Transaction\",\"description\":\"Learn how to find a subscriber, load all of their data and send a transaction to be processes by BrandWallet.\",\"dateModified\":\"2026-08-14T09:57:10.000Z\",\"isPartOf\":{\"@id\":\"https://docs.brand-wallet.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.brand-wallet.com/process/first-transaction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.brand-wallet.com/process/first-transaction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"BrandWallet\",\"item\":\"https://docs.brand-wallet.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Your First Transaction\",\"item\":\"https://docs.brand-wallet.com/process/first-transaction\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.brand-wallet.com/process/first-transaction#article\",\"headline\":\"Your First Transaction\",\"name\":\"Your First Transaction\",\"description\":\"Learn how to find a subscriber, load all of their data and send a transaction to be processes by BrandWallet.\",\"url\":\"https://docs.brand-wallet.com/process/first-transaction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.brand-wallet.com/process/first-transaction#webpage\"},\"dateModified\":\"2026-08-14T09:57:10.000Z\",\"publisher\":{\"@id\":\"https://docs.brand-wallet.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.brand-wallet.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"BrandWallet\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"BrandWallet","nav":{"global":null,"tabs":[{"tab":"User Guidelines","pages":[{"title":"User Guidelines","href":"/introduction-2"}]},{"tab":"Integrate with BrandWallet","groups":[{"group":"Get Started","pages":[{"title":"Headless Loyalty System","sidebarTitle":"Introduction","mode":"default","href":"/integrations/introduction"},{"title":"Start integrating with BrandWallet ","sidebarTitle":"Quickstart","href":"/integrations/quickstart"},{"title":"Authentication","sidebarTitle":"Authentication","href":"/integrations/authentication"},{"title":"Sync Data","sidebarTitle":"Sync Data","description":"Synchronize critical resources to BrandWallet","href":"/integrations/sync-data"}]},{"group":"Process a Digital Card","pages":[{"title":"Your First Transaction","sidebarTitle":"Your First Transaction","href":"/process/first-transaction"},{"title":"Find the Subscriber","sidebarTitle":"Find the Subscriber","description":null,"href":"/process/find-subscriber"},{"title":"Process Transaction","sidebarTitle":"Process Transaction","href":"/process/process-transaction"},{"title":"Get Customer Coupons","sidebarTitle":"Get Subscriber Coupons","href":"/process/get-coupons"},{"title":"Redeem a Coupon","sidebarTitle":"Redeem a Coupon","href":"/process/redeem-coupon"}]},{"group":"Webhooks","pages":[]},{"group":"Reference","pages":[{"title":"Standard Payload","href":"/untitled-page-8"},{"title":"Errors","href":"/untitled-page-9"}]}]},{"tab":"API","pages":[{"title":"API","href":"/api/overview"}]}]},"basePath":"","title":"Your First Transaction - BrandWallet","buildId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","deploymentId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","dynamics":[],"chunks":[]}