[{"data":1,"prerenderedAt":641},["ShallowReactive",2],{"navigation_docs":3,"-belong-checkin-developer-webhooks-and-pos":315,"-belong-checkin-developer-webhooks-and-pos-surround":636},[4,30,87,208,252],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-rocket",{"title":15,"path":16,"stem":17,"icon":18},"API","\u002Fgetting-started\u002Fapi-docs","1.getting-started\u002F2.api-docs","i-lucide-book-open-text",{"title":20,"path":21,"stem":22,"icon":23},"MCP","\u002Fgetting-started\u002Fmcp","1.getting-started\u002F3.mcp","i-lucide-bot",{"title":25,"path":26,"stem":27,"icon":28},"Smart Contract","\u002Fgetting-started\u002Fcontracts","1.getting-started\u002F5.contracts","i-lucide-clock",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Guides","\u002Fguides","2.guides",[35,72,82],{"title":36,"path":37,"stem":38,"children":39,"page":29},"Crypto","\u002Fguides\u002Fcrypto","2.guides\u002F1.crypto",[40,45,50,55,59,64,68],{"title":41,"path":42,"stem":43,"icon":44},"Belong CheckIn","\u002Fguides\u002Fcrypto\u002Fcheckin","2.guides\u002F1.crypto\u002FcheckIn","i-lucide-map-pin",{"title":46,"path":47,"stem":48,"icon":49},"EVM NFT Minting","\u002Fguides\u002Fcrypto\u002Fminting","2.guides\u002F1.crypto\u002Fminting","i-lucide-box",{"title":51,"path":52,"stem":53,"icon":54},"Sponsored Gas","\u002Fguides\u002Fcrypto\u002Fsponsorship","2.guides\u002F1.crypto\u002Fsponsorship","i-lucide-wallet",{"title":56,"path":57,"stem":58,"icon":49},"LONG Staking","\u002Fguides\u002Fcrypto\u002Fstaking","2.guides\u002F1.crypto\u002Fstaking",{"title":60,"path":61,"stem":62,"icon":63},"Starknet NFT Minting","\u002Fguides\u002Fcrypto\u002Fstarknet","2.guides\u002F1.crypto\u002Fstarknet","i-lucide-circuit-board",{"title":65,"path":66,"stem":67,"icon":49},"Sui NFT Minting","\u002Fguides\u002Fcrypto\u002Fsui","2.guides\u002F1.crypto\u002Fsui",{"title":69,"path":70,"stem":71,"icon":28},"LONG Vesting","\u002Fguides\u002Fcrypto\u002Fvesting","2.guides\u002F1.crypto\u002Fvesting",{"title":73,"path":74,"stem":75,"children":76,"page":29},"Media","\u002Fguides\u002Fmedia","2.guides\u002F2.media",[77],{"title":78,"path":79,"stem":80,"icon":81},"Media Upload","\u002Fguides\u002Fmedia\u002Fcollection","2.guides\u002F2.media\u002Fcollection","i-lucide-image",{"title":83,"path":84,"stem":85,"icon":86},"Whitelabel","\u002Fguides\u002Fwhitelabel","2.guides\u002F5.whitelabel","i-lucide-badge-check",{"title":41,"path":88,"stem":89,"children":90},"\u002Fbelong-checkin","3.belong-checkin",[91,94,99,104,109,114,118,123,127,132,137,171,175,180,185,189,194,199,203],{"title":92,"path":88,"stem":93,"icon":44},"Overview","3.belong-checkin\u002Findex",{"title":95,"path":96,"stem":97,"icon":98},"App Features","\u002Fbelong-checkin\u002Fapp-features","3.belong-checkin\u002F1.app-features","i-lucide-list-checks",{"title":100,"path":101,"stem":102,"icon":103},"Telegram Bot","\u002Fbelong-checkin\u002Ftelegram-bot","3.belong-checkin\u002F10.telegram-bot","i-lucide-send",{"title":105,"path":106,"stem":107,"icon":108},"Apple Wallet","\u002Fbelong-checkin\u002Fapple-wallet","3.belong-checkin\u002F11.apple-wallet","i-lucide-ticket",{"title":110,"path":111,"stem":112,"icon":113},"Payments","\u002Fbelong-checkin\u002Fpayments-and-onramp","3.belong-checkin\u002F12.payments-and-onramp","i-lucide-credit-card",{"title":51,"path":115,"stem":116,"icon":117},"\u002Fbelong-checkin\u002Fsponsored-gas","3.belong-checkin\u002F13.sponsored-gas","i-lucide-fuel",{"title":119,"path":120,"stem":121,"icon":122},"Fees & Staking","\u002Fbelong-checkin\u002Ffees-and-staking","3.belong-checkin\u002F14.fees-and-staking","i-lucide-percent",{"title":124,"path":125,"stem":126,"icon":23},"Connect AI Deploy","\u002Fbelong-checkin\u002Fconnect-ai-deploy","3.belong-checkin\u002F15.connect-ai-deploy",{"title":128,"path":129,"stem":130,"icon":131},"QR Signage Examples","\u002Fbelong-checkin\u002Fvenue-qr-signage-examples","3.belong-checkin\u002F16.venue-qr-signage-examples","i-lucide-qr-code",{"title":133,"path":134,"stem":135,"icon":136},"Whitepaper","\u002Fbelong-checkin\u002Fwhitepaper","3.belong-checkin\u002F18.whitepaper","i-lucide-file-text",{"title":138,"icon":139,"path":140,"stem":141,"children":142,"page":29},"Developer","i-lucide-code","\u002Fbelong-checkin\u002Fdeveloper","3.belong-checkin\u002F19.developer",[143,148,152,156,161,166],{"title":144,"path":145,"stem":146,"icon":147},"Integration Overview","\u002Fbelong-checkin\u002Fdeveloper\u002Fintegration-overview","3.belong-checkin\u002F19.developer\u002F1.integration-overview","i-lucide-plug",{"title":149,"path":150,"stem":151,"icon":18},"API Reference","\u002Fbelong-checkin\u002Fdeveloper\u002Fapi-reference","3.belong-checkin\u002F19.developer\u002F2.api-reference",{"title":153,"path":154,"stem":155,"icon":23},"MCP Tools","\u002Fbelong-checkin\u002Fdeveloper\u002Fmcp-tools","3.belong-checkin\u002F19.developer\u002F3.mcp-tools",{"title":157,"path":158,"stem":159,"icon":160},"Networks","\u002Fbelong-checkin\u002Fdeveloper\u002Fnetworks","3.belong-checkin\u002F19.developer\u002F4.networks","i-lucide-network",{"title":162,"path":163,"stem":164,"icon":165},"Enterprise Apps","\u002Fbelong-checkin\u002Fdeveloper\u002Fenterprise-whitelabel","3.belong-checkin\u002F19.developer\u002F5.enterprise-whitelabel","i-lucide-package",{"title":167,"path":168,"stem":169,"icon":170},"POS & Events","\u002Fbelong-checkin\u002Fdeveloper\u002Fwebhooks-and-pos","3.belong-checkin\u002F19.developer\u002F6.webhooks-and-pos","i-lucide-receipt",{"title":172,"path":173,"stem":174,"icon":131},"Check-In Modes","\u002Fbelong-checkin\u002Fcheck-in-modes","3.belong-checkin\u002F2.check-in-modes",{"title":176,"path":177,"stem":178,"icon":179},"Venue Quick Start","\u002Fbelong-checkin\u002Fvenue-quickstart","3.belong-checkin\u002F3.venue-quickstart","i-lucide-store",{"title":181,"path":182,"stem":183,"icon":184},"Customer Rewards","\u002Fbelong-checkin\u002Fcustomer_rewards_guide","3.belong-checkin\u002F4.customer_rewards_guide","i-lucide-gift",{"title":186,"path":187,"stem":188,"icon":54},"Promoter Earnings","\u002Fbelong-checkin\u002Fpromoter-earnings-guide","3.belong-checkin\u002F5.promoter-earnings-guide",{"title":190,"path":191,"stem":192,"icon":193},"Venue Partner","\u002Fbelong-checkin\u002Fvenue-partner","3.belong-checkin\u002F6.venue-partner","i-lucide-building",{"title":195,"path":196,"stem":197,"icon":198},"Event Creation","\u002Fbelong-checkin\u002Fevent-creation","3.belong-checkin\u002F7.event-creation","i-lucide-calendar-plus",{"title":200,"path":201,"stem":202,"icon":54},"Wallet & Sign-In","\u002Fbelong-checkin\u002Fwallet-and-auth","3.belong-checkin\u002F8.wallet-and-auth",{"title":204,"path":205,"stem":206,"icon":207},"AI & Voice","\u002Fbelong-checkin\u002Fai-and-voice","3.belong-checkin\u002F9.ai-and-voice","i-lucide-mic",{"title":209,"path":210,"stem":211,"children":212,"page":29},"MCP Cheat Sheet","\u002Fmcp","4.mcp",[213,216,220,224,228,232,236,240,244,248],{"title":92,"path":214,"stem":215,"icon":23},"\u002Fmcp\u002Foverview","4.mcp\u002Foverview",{"title":217,"path":218,"stem":219,"icon":23},"Addresses","\u002Fmcp\u002Ftools-addresses","4.mcp\u002Ftools-addresses",{"title":221,"path":222,"stem":223,"icon":23},"CheckIn","\u002Fmcp\u002Ftools-check-in","4.mcp\u002Ftools-check-In",{"title":225,"path":226,"stem":227,"icon":23},"Events","\u002Fmcp\u002Ftools-events","4.mcp\u002Ftools-events",{"title":229,"path":230,"stem":231,"icon":23},"Hubs","\u002Fmcp\u002Ftools-hubs","4.mcp\u002Ftools-hubs",{"title":233,"path":234,"stem":235,"icon":49},"Minting","\u002Fmcp\u002Ftools-minting","4.mcp\u002Ftools-minting",{"title":237,"path":238,"stem":239,"icon":23},"Notes","\u002Fmcp\u002Ftools-notes","4.mcp\u002Ftools-notes",{"title":241,"path":242,"stem":243,"icon":23},"Registration","\u002Fmcp\u002Ftools-registration","4.mcp\u002Ftools-registration",{"title":245,"path":246,"stem":247,"icon":23},"Starknet","\u002Fmcp\u002Ftools-starknet","4.mcp\u002Ftools-starknet",{"title":249,"path":250,"stem":251,"icon":28},"Vesting","\u002Fmcp\u002Ftools-vesting","4.mcp\u002Ftools-vesting",{"title":253,"icon":13,"path":254,"stem":255,"children":256,"page":29},"Belong AI Deploy","\u002Fai-deploy","5.ai-deploy",[257,260,265,270,275,295,300,305,310],{"title":92,"path":258,"stem":259,"icon":13},"\u002Fai-deploy\u002Foverview","5.ai-deploy\u002F1.overview",{"title":261,"path":262,"stem":263,"icon":264},"Quick Start","\u002Fai-deploy\u002Fquickstart","5.ai-deploy\u002F2.quickstart","i-lucide-zap",{"title":266,"path":267,"stem":268,"icon":269},"Cloud Providers","\u002Fai-deploy\u002Fcloud-providers","5.ai-deploy\u002F3.cloud-providers","i-lucide-cloud",{"title":271,"path":272,"stem":273,"icon":274},"AI Providers","\u002Fai-deploy\u002Fai-providers","5.ai-deploy\u002F4.ai-providers","i-lucide-brain",{"title":276,"icon":277,"path":278,"stem":279,"children":280,"page":29},"Channels","i-lucide-messages-square","\u002Fai-deploy\u002Fchannels","5.ai-deploy\u002F5.channels",[281,285,290],{"title":282,"path":283,"stem":284,"icon":103},"Telegram","\u002Fai-deploy\u002Fchannels\u002Ftelegram","5.ai-deploy\u002F5.channels\u002F1.telegram",{"title":286,"path":287,"stem":288,"icon":289},"WhatsApp","\u002Fai-deploy\u002Fchannels\u002Fwhatsapp","5.ai-deploy\u002F5.channels\u002F2.whatsapp","i-lucide-message-circle",{"title":291,"path":292,"stem":293,"icon":294},"Slack","\u002Fai-deploy\u002Fchannels\u002Fslack","5.ai-deploy\u002F5.channels\u002F3.slack","i-lucide-hash",{"title":296,"path":297,"stem":298,"icon":299},"Private Access","\u002Fai-deploy\u002Fprivate-access","5.ai-deploy\u002F6.private-access","i-lucide-shield",{"title":301,"path":302,"stem":303,"icon":304},"Troubleshooting","\u002Fai-deploy\u002Ftroubleshooting","5.ai-deploy\u002F7.troubleshooting","i-lucide-wrench",{"title":306,"path":307,"stem":308,"icon":309},"Enterprise & API","\u002Fai-deploy\u002Fenterprise-api","5.ai-deploy\u002F8.enterprise-api","i-lucide-server-cog",{"title":311,"path":312,"stem":313,"icon":314},"OVHcloud","\u002Fai-deploy\u002Fovhcloud","5.ai-deploy\u002F9.ovhcloud","i-lucide-cloud-cog",{"id":316,"title":317,"body":318,"description":629,"extension":630,"links":631,"meta":632,"navigation":633,"path":168,"seo":634,"stem":169,"__hash__":635},"docs\u002F3.belong-checkin\u002F19.developer\u002F6.webhooks-and-pos.md","POS & Check-In Events",{"type":319,"value":320,"toc":622},"minimark",[321,325,329,333,346,349,503,507,510,565,568,572,588,600,604,618],[322,323,92],"h2",{"id":324},"overview",[326,327,328],"p",{},"This page covers integrating a point-of-sale (POS) or back-office system with Belong CheckIn: collecting staff-confirmed payments via QR, and attributing each check-in to where it came from.",[322,330,332],{"id":331},"payment-request-qr-pos-pattern","Payment-request QR (POS pattern)",[326,334,335,336,340,341,345],{},"The primary POS integration is the ",[337,338,339],"strong",{},"payment-request QR",": the customer scans, staff enter the amount from your POS, and the customer pays from their wallet. This reuses the venue owner-quote payment flow — no separate access mode is needed. See the ",[342,343,110],"a",{"href":344},"\u002Fbelong-checkin\u002Fpayments-and-onramp#payment-request-qr"," guide for the operator and customer flows.",[326,347,348],{},"A payment-request QR encodes a small payload (distinct from the standard check-in QR) and the app re-validates the venue's settings on every scan, so a stale QR can't be used to force a payment:",[350,351,356],"pre",{"className":352,"code":353,"language":354,"meta":355,"style":355},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","type VenuePaymentRequestQRData = {\n  type: 'venue_payment_request'\n  hubId: string\n  hubName: string\n  venueWallet?: string\n  locationLabel?: string\n  source: 'venue_static_qr' | 'checkin_qr' | 'pos_receipt_qr'\n  timestamp: number\n  version: number\n}\n","ts","",[357,358,359,379,399,410,420,431,441,476,487,497],"code",{"__ignoreMap":355},[360,361,364,368,372,376],"span",{"class":362,"line":363},"line",1,[360,365,367],{"class":366},"spNyl","type",[360,369,371],{"class":370},"sBMFI"," VenuePaymentRequestQRData",[360,373,375],{"class":374},"sMK4o"," =",[360,377,378],{"class":374}," {\n",[360,380,382,386,389,392,396],{"class":362,"line":381},2,[360,383,385],{"class":384},"swJcz","  type",[360,387,388],{"class":374},":",[360,390,391],{"class":374}," '",[360,393,395],{"class":394},"sfazB","venue_payment_request",[360,397,398],{"class":374},"'\n",[360,400,402,405,407],{"class":362,"line":401},3,[360,403,404],{"class":384},"  hubId",[360,406,388],{"class":374},[360,408,409],{"class":370}," string\n",[360,411,413,416,418],{"class":362,"line":412},4,[360,414,415],{"class":384},"  hubName",[360,417,388],{"class":374},[360,419,409],{"class":370},[360,421,423,426,429],{"class":362,"line":422},5,[360,424,425],{"class":384},"  venueWallet",[360,427,428],{"class":374},"?:",[360,430,409],{"class":370},[360,432,434,437,439],{"class":362,"line":433},6,[360,435,436],{"class":384},"  locationLabel",[360,438,428],{"class":374},[360,440,409],{"class":370},[360,442,444,447,449,451,454,457,460,462,465,467,469,471,474],{"class":362,"line":443},7,[360,445,446],{"class":384},"  source",[360,448,388],{"class":374},[360,450,391],{"class":374},[360,452,453],{"class":394},"venue_static_qr",[360,455,456],{"class":374},"'",[360,458,459],{"class":374}," |",[360,461,391],{"class":374},[360,463,464],{"class":394},"checkin_qr",[360,466,456],{"class":374},[360,468,459],{"class":374},[360,470,391],{"class":374},[360,472,473],{"class":394},"pos_receipt_qr",[360,475,398],{"class":374},[360,477,479,482,484],{"class":362,"line":478},8,[360,480,481],{"class":384},"  timestamp",[360,483,388],{"class":374},[360,485,486],{"class":370}," number\n",[360,488,490,493,495],{"class":362,"line":489},9,[360,491,492],{"class":384},"  version",[360,494,388],{"class":374},[360,496,486],{"class":370},[360,498,500],{"class":362,"line":499},10,[360,501,502],{"class":374},"}\n",[322,504,506],{"id":505},"check-in-attribution","Check-in attribution",[326,508,509],{},"Each check-in records where the request originated, so you can reconcile against your POS:",[511,512,513,529],"table",{},[514,515,516],"thead",{},[517,518,519,523,526],"tr",{},[520,521,522],"th",{},"Field",[520,524,525],{},"Values",[520,527,528],{},"Meaning",[530,531,532,552],"tbody",{},[517,533,534,540,549],{},[535,536,537],"td",{},[357,538,539],{},"payment_request_source",[535,541,542,544,545,544,547],{},[357,543,464],{},", ",[357,546,453],{},[357,548,473],{},[535,550,551],{},"Whether the request came from the standard check-in QR, a static venue QR, or a POS receipt QR",[517,553,554,559,562],{},[535,555,556],{},[357,557,558],{},"payment_request_label",[535,560,561],{},"free text",[535,563,564],{},"Optional staff-facing label such as a table, bar, patio, or register",[326,566,567],{},"These are runtime attribution fields — they don't change a venue's check-in configuration, which stays in the venue's settings.",[322,569,571],{"id":570},"reading-check-in-activity","Reading check-in activity",[573,574,575,582],"ul",{},[576,577,578,581],"li",{},[337,579,580],{},"Pending requests"," — staff surfaces read pending owner-quote requests (with source and label) so they can send the amount",[576,583,584,587],{},[337,585,586],{},"History"," — venue operators can review recent check-ins and reward activity from their venue's CheckIn area",[589,590,591,592,595,596,599],"note",{},"For programmatic access to events and hubs, use the ",[342,593,594],{"href":145},"Belong API"," with your ",[357,597,598],{},"x-api-key",". Outbound event webhooks (push notifications to your own endpoint on each check-in) are on the roadmap; today, integrate by reading check-in and venue data through the API.",[322,601,603],{"id":602},"related","Related",[573,605,606,610,614],{},[576,607,608],{},[342,609,110],{"href":111},[576,611,612],{},[342,613,176],{"href":177},[576,615,616],{},[342,617,144],{"href":145},[619,620,621],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":355,"searchDepth":381,"depth":381,"links":623},[624,625,626,627,628],{"id":324,"depth":381,"text":92},{"id":331,"depth":381,"text":332},{"id":505,"depth":381,"text":506},{"id":570,"depth":381,"text":571},{"id":602,"depth":381,"text":603},"Integrate point-of-sale systems and back-office tools with Belong CheckIn using payment-request QR and check-in attribution.","md",null,{},{"title":167,"icon":170},{"title":317,"description":629},"wiB-fL7zCq8ALS1AFUJbnGwrUUGU1oBaFslwk8E1Koc",[637,639],{"title":162,"path":163,"stem":164,"description":638,"icon":165,"children":-1},"Belong can build and operate branded Belong CheckIn apps for enterprise customers.",{"title":172,"path":173,"stem":174,"description":640,"icon":131,"children":-1},"The four access modes — free, venue payment, NFT ticket, and NFT membership — and how the universal check-in flow adapts to each.",1785598154338]