What happened to the pass. Use channel for in-store vs online and tapMode for single- vs double-tap; the legacy ONLINE / PASS_AND_PAYMENT / PASS_ONLY / PAYMENT_ONLY values are rejected.
ISO 8601 timestamp when transaction occurred (defaults to now). Accepts both timezone-bearing (2026-06-02T12:13:14Z) and timezone-less (2026-06-02T12:13:14, treated as UTC) forms.
Custom data attached to the transaction. Only pos, posData, posRegisterId, posEftPosText, pspData, mcc, and lineItems are accepted — posData/pspData accept arbitrary JSON, everything else does not.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Stell","description":"Guides and API reference for Stell: design, issue and update Apple Wallet and Google Wallet passes for loyalty, memberships, tickets and access.","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/stell/C_zhUrQoTUQsZ2Th/logo/light.svg?fit=max\u0026auto=format\u0026n=C_zhUrQoTUQsZ2Th\u0026q=85\u0026s=0331e63db80863763f108a9e957b9b1d","dark":"https://mintcdn.com/stell/C_zhUrQoTUQsZ2Th/logo/dark.svg?fit=max\u0026auto=format\u0026n=C_zhUrQoTUQsZ2Th\u0026q=85\u0026s=887c7ef4687b8beb0bfc6263349c508b"},"favicon":"https://mintcdn.com/stell/k_mnJ8Kr2DM3UI1t/favicon.svg?fit=max\u0026auto=format\u0026n=k_mnJ8Kr2DM3UI1t\u0026q=85\u0026s=c10d1de1b75b3b3a459cd9b2634f566f","api":{"playground":{"display":"simple"},"examples":{"languages":["typescript","bash","python"],"prefill":true},"url":"full"},"navbar":{"links":[{"href":"https://getstell.com/contact?context=docs:navbar","label":"Talk to Stell"},{"href":"mailto:hello@getstell.com","label":"Support"}],"primary":{"type":"button","label":"Open portal","href":"https://platform.getstell.com/portal"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/stell-tech-as","youtube":"https://www.youtube.com/@getstell","github":"https://github.com/Stell-Tech"},"links":[{"items":[{"label":"getstell.com","href":"https://getstell.com"},{"label":"Book a demo","href":"https://getstell.com/contact?context=docs:footer"},{"label":"Partners and integrations","href":"https://getstell.com/partners"},{"label":"Support","href":"mailto:hello@getstell.com"}]}]},"seo":{"metatags":{"canonical":"https://docs.getstell.com","og:site_name":"Stell Docs","twitter:card":"summary_large_image"},"organization":{"id":"https://getstell.com/#organization","name":"Stell","legalName":"Stell Tech AS","url":"https://getstell.com","logo":"https://getstell.com/brand/stell-wordmark-navy.svg","sameAs":["https://www.linkedin.com/company/stell-tech-as/","https://www.youtube.com/@getstell","https://github.com/Stell-Tech"]}},"contextual":{"options":["copy","view","claude","chatgpt","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"stell","hasAudioNarration":false,"actualSubdomain":"stell","customDomains":["docs.getstell.com"],"gitSource":{"type":"github","owner":"stell-tech","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aea58a7dfbaebaa6b1d3912","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API reference","count":64},{"language":"default","tag":"Merchant portal","count":20},{"language":"default","tag":"Passes","count":15},{"language":"default","tag":"Launch \u0026 grow","count":13},{"language":"default","tag":"Programs","count":8},{"language":"default","tag":"Pass Templates","count":7},{"language":"default","tag":"Engage","count":6},{"language":"default","tag":"Pass templates","count":6},{"language":"default","tag":"Engagement","count":6},{"language":"default","tag":"Integration guide","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".frame{margin-top:1.75rem;margin-bottom:1.75rem}.task-list-item::before{content:none}.task-list-item{position:relative;margin-left:10px}.task-list-item>input[type=\"checkbox\"]{position:absolute;left:-2px;top:7px;margin:0}"}],"page":{"pagePath":"api-reference/transactions/create-transaction","slug":"/api-reference/transactions/create-transaction","pageMetadata":{"title":"Create transaction","description":"Record a new transaction against a pass.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/transactions","href":"/api-reference/transactions/create-transaction","autogeneratedByOpenApi":true},"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: \"Record a new transaction against a pass.\"\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":"Create transaction","description":"Record a new transaction against a pass.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/transactions","href":"/api-reference/transactions/create-transaction","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Transactions"],"summary":"Create transaction","description":"Record a new transaction against a pass.","operationId":"createTransaction","requestBody":"bf895a97-d6ee-4f84-b8b1-8ca67d28b975","responses":{"201":"69b4f8a9-3ddc-4341-a1eb-36f6013d60bd","400":"abdd0590-a117-4b9a-97b8-56941ccadf68","401":"08898b9b-621c-47ee-bf6f-f53ddc874aac","403":"611b9561-c4ce-4842-8882-9d79713021b2","404":"ac8444cf-7c4c-4ac7-85b4-5d98bed55ea5","500":"ecc80e2f-6589-46ec-bc43-dcbbd3b892cc"},"security":["29791f7e-3ba8-451e-af3c-3656b1eab42c"],"method":"post","type":"path","servers":["7cb07a26-83f2-4be3-9415-240d75b0dd81"],"path":"/v1/transactions","baseUrlOptions":["https://api.platform.getstell.com"],"title":"Create transaction","codeSamples":[],"requestExampleLanguages":["typescript","bash","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.passId":"\u003cstring>","body.pointsSpent":1,"body.remainingUsesBefore":123,"body.terminalId":"\u003cstring>","body.storeId":"\u003cstring>","body.transactionDate":"\u003cstring>","body.reference":"\u003cstring>","body.pointsEarned":1,"body.statusReason":"\u003cstring>","body.remainingUsesAfter":123,"body.payment.reference":"\u003cstring>","body.payment.pspReference":"\u003cstring>","body.additionalData.posRegisterId":"\u003cstring>","body.additionalData.lineItems.items.0.quantity":123,"body.additionalData.lineItems.items.0.color":"\u003cstring>","body.additionalData.lineItems.items.0.itemCategory":"\u003cstring>","body.additionalData.lineItems.items.0.amountExcludingTax.currency":"\u003cstring>","body.additionalData.lineItems.items.0.amountExcludingTax.value":123,"body.additionalData.lineItems.items.0.taxPercentage":123,"body.additionalData.lineItems.items.0.description":"\u003cstring>","body.additionalData.lineItems.items.0.upc":"\u003cstring>","body.additionalData.lineItems.items.0.manufacturer":"\u003cstring>","body.additionalData.lineItems.items.0.size":"\u003cstring>","body.additionalData.lineItems.items.0.imageUrl":"\u003cstring>","body.additionalData.lineItems.items.0.amountIncludingTax.currency":"\u003cstring>","body.additionalData.lineItems.items.0.amountIncludingTax.value":123,"body.additionalData.lineItems.items.0.productUrl":"\u003cstring>","body.additionalData.lineItems.items.0.sku":"\u003cstring>","body.additionalData.lineItems.items.0.taxAmount.currency":"\u003cstring>","body.additionalData.lineItems.items.0.taxAmount.value":123,"body.additionalData.lineItems.items.0.brand":"\u003cstring>","body.additionalData.posEftPosText":"\u003cstring>","body.additionalData.pos":"\u003cstring>","body.additionalData.posData":{},"body.additionalData.pspData":{},"body.additionalData.mcc":123}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"title":"CreateTransactionModel","required":["passId","type"],"type":"object","properties":{"passId":{"type":"string","description":"ID of the pass to record transaction for","isRequired":true,"uniqueKey":"passId","typeLabel":"string"},"type":{"type":"string","description":"What happened to the pass. Use channel for in-store vs online and tapMode for single- vs double-tap; the legacy ONLINE / PASS_AND_PAYMENT / PASS_ONLY / PAYMENT_ONLY values are rejected.","enum":["PURCHASE","REDEMPTION","POINTS_ADJUSTMENT","SCAN_ONLY","CHECK_IN","CHECK_OUT","UNKNOWN"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"tapMode":{"type":"string","description":"Whether pass and payment were captured in one terminal tap (SINGLE_TAP), separate taps (DOUBLE_TAP), or without a terminal (NONE)","enum":["SINGLE_TAP","DOUBLE_TAP","NONE"],"uniqueKey":"tapMode","typeLabel":"enum\u003cstring>"},"pointsSpent":{"minimum":0,"type":"integer","description":"Loyalty points redeemed in this transaction","uniqueKey":"pointsSpent","typeLabel":"integer"},"channel":{"type":"string","description":"Where the customer was: IN_STORE or ONLINE","enum":["IN_STORE","ONLINE"],"uniqueKey":"channel","typeLabel":"enum\u003cstring>"},"instrument":{"type":"string","description":"How the pass was presented (Apple VAS, Google Smart Tap, QR, NFC, MIFARE). The payment method goes in payment.method.","enum":["APPLE_VAS","GOOGLE_SMART_TAP","QR","NFC_TYPE_1","NFC_TYPE_2","NFC_TYPE_3","NFC_TYPE_4","NFC_TYPE_5","MIFARE","OTHER"],"uniqueKey":"instrument","typeLabel":"enum\u003cstring>"},"remainingUsesBefore":{"maximum":2147483647,"type":"integer","description":"Number of remaining uses before this transaction (for access control)","uniqueKey":"remainingUsesBefore","typeLabel":"integer"},"terminalId":{"type":"string","description":"ID of the terminal that processed the transaction","uniqueKey":"terminalId","typeLabel":"string"},"storeId":{"type":"string","description":"ID of the store where transaction occurred","uniqueKey":"storeId","typeLabel":"string"},"transactionDate":{"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})?$","type":"string","description":"ISO 8601 timestamp when transaction occurred (defaults to now). Accepts both timezone-bearing (2026-06-02T12:13:14Z) and timezone-less (2026-06-02T12:13:14, treated as UTC) forms.","uniqueKey":"transactionDate","typeLabel":"string"},"reference":{"maxLength":255,"type":"string","description":"External transaction reference or receipt number","uniqueKey":"reference","typeLabel":"string"},"pointsEarned":{"minimum":0,"type":"integer","description":"Loyalty points earned in this transaction","uniqueKey":"pointsEarned","typeLabel":"integer"},"statusReason":{"maxLength":500,"type":"string","description":"Reason for transaction status (e.g., denial reason)","uniqueKey":"statusReason","typeLabel":"string"},"remainingUsesAfter":{"maximum":2147483647,"type":"integer","description":"Number of remaining uses after this transaction (for access control)","uniqueKey":"remainingUsesAfter","typeLabel":"integer"},"payment":{"type":"object","properties":{"reference":{"maxLength":255,"type":"string","description":"Payment reference identifier","uniqueKey":"payment.reference","typeLabel":"string"},"amount":{"required":["currency","value"],"type":"object","properties":{"currency":{"pattern":"^[A-Z]{3}$","type":"string","description":"ISO 4217 currency code (e.g., USD, EUR, GBP)","isRequired":true,"uniqueKey":"payment.amount.currency","typeLabel":"string"},"value":{"minimum":0,"type":"number","description":"Payment amount value","isRequired":true,"uniqueKey":"payment.amount.value","typeLabel":"number"}},"additionalProperties":false,"description":"Payment amount details","uniqueKey":"payment.amount","typeLabel":"object"},"method":{"type":"string","description":"How the customer paid (Apple Pay, Google Pay, card, cash, Vipps, MobilePay, ...)","enum":["APPLE_PAY","GOOGLE_PAY","SAMSUNG_PAY","CARD","CASH","VIPPS","MOBILEPAY","OTHER"],"uniqueKey":"payment.method","typeLabel":"enum\u003cstring>"},"pspReference":{"maxLength":255,"type":"string","description":"Payment service provider reference","uniqueKey":"payment.pspReference","typeLabel":"string"}},"additionalProperties":false,"description":"Payment details for the transaction","uniqueKey":"payment","typeLabel":"object"},"additionalData":{"type":"object","properties":{"posRegisterId":{"type":"string","description":"Identifier of the Point of Sale register","uniqueKey":"additionalData.posRegisterId","typeLabel":"string"},"lineItems":{"type":"array","description":"Line items involved in the transaction","items":{"type":"object","properties":{"quantity":{"type":"integer","description":"Quantity of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].quantity","typeLabel":"integer"},"color":{"type":"string","description":"Color of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].color","typeLabel":"string"},"itemCategory":{"type":"string","description":"Category of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].itemCategory","typeLabel":"string"},"amountExcludingTax":{"type":"object","properties":{"currency":{"pattern":"^[A-Z]{3}$","type":"string","description":"ISO 4217 currency code (e.g., USD, EUR, GBP)","uniqueKey":"additionalData.lineItems.items.[INDEX].amountExcludingTax.currency","typeLabel":"string"},"value":{"type":"number","description":"The value of the amount","uniqueKey":"additionalData.lineItems.items.[INDEX].amountExcludingTax.value","typeLabel":"number"}},"additionalProperties":false,"description":"A monetary amount","uniqueKey":"additionalData.lineItems.items.[INDEX].amountExcludingTax","typeLabel":"object"},"taxPercentage":{"type":"number","description":"Tax percentage for the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].taxPercentage","typeLabel":"number"},"description":{"type":"string","description":"Description of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].description","typeLabel":"string"},"upc":{"type":"string","description":"UPC of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].upc","typeLabel":"string"},"manufacturer":{"type":"string","description":"Manufacturer of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].manufacturer","typeLabel":"string"},"size":{"type":"string","description":"Size of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].size","typeLabel":"string"},"imageUrl":{"type":"string","description":"Image URL of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].imageUrl","typeLabel":"string"},"amountIncludingTax":{"type":"object","properties":{"currency":{"pattern":"^[A-Z]{3}$","type":"string","description":"ISO 4217 currency code (e.g., USD, EUR, GBP)","uniqueKey":"additionalData.lineItems.items.[INDEX].amountIncludingTax.currency","typeLabel":"string"},"value":{"type":"number","description":"The value of the amount","uniqueKey":"additionalData.lineItems.items.[INDEX].amountIncludingTax.value","typeLabel":"number"}},"additionalProperties":false,"description":"A monetary amount","uniqueKey":"additionalData.lineItems.items.[INDEX].amountIncludingTax","typeLabel":"object"},"productUrl":{"type":"string","description":"Product URL of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].productUrl","typeLabel":"string"},"sku":{"type":"string","description":"SKU of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].sku","typeLabel":"string"},"taxAmount":{"type":"object","properties":{"currency":{"pattern":"^[A-Z]{3}$","type":"string","description":"ISO 4217 currency code (e.g., USD, EUR, GBP)","uniqueKey":"additionalData.lineItems.items.[INDEX].taxAmount.currency","typeLabel":"string"},"value":{"type":"number","description":"The value of the amount","uniqueKey":"additionalData.lineItems.items.[INDEX].taxAmount.value","typeLabel":"number"}},"additionalProperties":false,"description":"A monetary amount","uniqueKey":"additionalData.lineItems.items.[INDEX].taxAmount","typeLabel":"object"},"brand":{"type":"string","description":"Brand of the line item","uniqueKey":"additionalData.lineItems.items.[INDEX].brand","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"additionalData.lineItems.items.[INDEX]","typeLabel":"object"},"uniqueKey":"additionalData.lineItems","typeLabel":"object[]"},"posEftPosText":{"type":"string","description":"Text from the Point of Sale Electronic Funds Transfer system","uniqueKey":"additionalData.posEftPosText","typeLabel":"string"},"pos":{"type":"string","description":"Point of Sale identifier","uniqueKey":"additionalData.pos","typeLabel":"string"},"posData":{"type":"object","additionalProperties":true,"description":"Additional data from the Point of Sale system (arbitrary JSON)","uniqueKey":"additionalData.posData","typeLabel":"object"},"pspData":{"type":"object","additionalProperties":true,"description":"Additional data from the Payment Service Provider (arbitrary JSON)","uniqueKey":"additionalData.pspData","typeLabel":"object"},"mcc":{"type":"integer","description":"Merchant Category Code as per ISO 18245:2023","uniqueKey":"additionalData.mcc","typeLabel":"integer"}},"additionalProperties":false,"description":"Custom data attached to the transaction. Only pos, posData, posRegisterId, posEftPosText, pspData, mcc, and lineItems are accepted — posData/pspData accept arbitrary JSON, everything else does not.","uniqueKey":"additionalData","typeLabel":"object"},"status":{"type":"string","description":"Transaction status","enum":["APPROVED","DENIED","FAILED","PENDING"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"}},"description":"Data required to record a new transaction.","uniqueKey":"","typeLabel":"CreateTransactionModel · object"},"examples":{"Example":{"title":"Example","value":{"passId":"\u003cstring>","pointsSpent":1,"remainingUsesBefore":123,"terminalId":"\u003cstring>","storeId":"\u003cstring>","transactionDate":"\u003cstring>","reference":"\u003cstring>","pointsEarned":1,"statusReason":"\u003cstring>","remainingUsesAfter":123,"payment":{"reference":"\u003cstring>","pspReference":"\u003cstring>"},"additionalData":{"posRegisterId":"\u003cstring>","lineItems":[{"quantity":123,"color":"\u003cstring>","itemCategory":"\u003cstring>","amountExcludingTax":{"currency":"\u003cstring>","value":123},"taxPercentage":123,"description":"\u003cstring>","upc":"\u003cstring>","manufacturer":"\u003cstring>","size":"\u003cstring>","imageUrl":"\u003cstring>","amountIncludingTax":{"currency":"\u003cstring>","value":123},"productUrl":"\u003cstring>","sku":"\u003cstring>","taxAmount":{"currency":"\u003cstring>","value":123},"brand":"\u003cstring>"}],"posEftPosText":"\u003cstring>","pos":"\u003cstring>","posData":{},"pspData":{},"mcc":123}}}},"exampleType":"generated"}},"required":true,"description":"Transaction details","exampleType":"generated"},"responses":{"69b4f8a9-3ddc-4341-a1eb-36f6013d60bd":{"description":"Transaction created successfully","content":{"application/json":{"schema":{"title":"TransactionResponseModel","required":["data","requestId"],"type":"object","properties":{"data":{"title":"TransactionModel","required":["createdAt","id","passId","transactionDate","type","updatedAt"],"type":"object","properties":{"passId":{"type":"string","description":"ID of the pass associated with this transaction","isRequired":true,"uniqueKey":"data.passId","typeLabel":"string"},"type":{"type":"string","description":"What happened to the pass. ONLINE, PASS_AND_PAYMENT, PASS_ONLY and PAYMENT_ONLY only appear on transactions recorded before channel and tapMode existed.","enum":["PURCHASE","REDEMPTION","POINTS_ADJUSTMENT","SCAN_ONLY","CHECK_IN","CHECK_OUT","UNKNOWN","ONLINE","PASS_AND_PAYMENT","PASS_ONLY","PAYMENT_ONLY"],"isRequired":true,"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"transactionDate":{"type":"string","description":"When the transaction occurred","format":"date-time","isRequired":true,"uniqueKey":"data.transactionDate","typeLabel":"string\u003cdate-time>"},"createdAt":{"type":"string","description":"When the transaction was created","format":"date-time","isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"id":{"type":"string","description":"Unique transaction identifier","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"updatedAt":{"type":"string","description":"When the transaction was last updated","format":"date-time","isRequired":true,"uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"},"tapMode":{"type":"string","description":"Whether pass and payment were captured in one terminal tap (SINGLE_TAP), separate taps (DOUBLE_TAP), or without a terminal (NONE)","enum":["SINGLE_TAP","DOUBLE_TAP","NONE"],"uniqueKey":"data.tapMode","typeLabel":"enum\u003cstring>"},"pointsSpent":{"type":"number","description":"Loyalty points redeemed in this transaction","uniqueKey":"data.pointsSpent","typeLabel":"number"},"channel":{"type":"string","description":"Where the customer was: IN_STORE or ONLINE","enum":["IN_STORE","ONLINE"],"uniqueKey":"data.channel","typeLabel":"enum\u003cstring>"},"instrument":{"type":"string","description":"How the pass was presented. CARD, CASH and MOBILE only appear on transactions recorded before payment.method existed.","enum":["APPLE_VAS","GOOGLE_SMART_TAP","QR","NFC_TYPE_1","NFC_TYPE_2","NFC_TYPE_3","NFC_TYPE_4","NFC_TYPE_5","MIFARE","OTHER","CARD","CASH","MOBILE"],"uniqueKey":"data.instrument","typeLabel":"enum\u003cstring>"},"remainingUsesBefore":{"type":"integer","description":"Number of remaining uses before this transaction (for access control)","uniqueKey":"data.remainingUsesBefore","typeLabel":"integer"},"terminalId":{"type":"string","description":"ID of the terminal that processed the transaction","uniqueKey":"data.terminalId","typeLabel":"string"},"storeId":{"type":"string","description":"ID of the store where transaction occurred","uniqueKey":"data.storeId","typeLabel":"string"},"reference":{"type":"string","description":"External transaction reference","uniqueKey":"data.reference","typeLabel":"string"},"pointsEarned":{"type":"number","description":"Loyalty points earned in this transaction","uniqueKey":"data.pointsEarned","typeLabel":"number"},"statusReason":{"type":"string","description":"Reason for transaction status (e.g., denial reason)","uniqueKey":"data.statusReason","typeLabel":"string"},"remainingUsesAfter":{"type":"integer","description":"Number of remaining uses after this transaction (for access control)","uniqueKey":"data.remainingUsesAfter","typeLabel":"integer"},"payment":{"type":"object","properties":{"reference":{"type":"string","description":"Payment reference identifier","uniqueKey":"data.payment.reference","typeLabel":"string"},"amount":{"type":"object","properties":{"currency":{"pattern":"^[A-Z]{3}$","type":"string","description":"ISO 4217 currency code","uniqueKey":"data.payment.amount.currency","typeLabel":"string"},"value":{"minimum":0,"type":"number","description":"Payment amount value","uniqueKey":"data.payment.amount.value","typeLabel":"number"}},"additionalProperties":false,"description":"Payment amount details","uniqueKey":"data.payment.amount","typeLabel":"object"},"method":{"type":"string","description":"How the customer paid","enum":["APPLE_PAY","GOOGLE_PAY","SAMSUNG_PAY","CARD","CASH","VIPPS","MOBILEPAY","OTHER"],"uniqueKey":"data.payment.method","typeLabel":"enum\u003cstring>"},"pspReference":{"type":"string","description":"Payment service provider reference","uniqueKey":"data.payment.pspReference","typeLabel":"string"}},"additionalProperties":false,"description":"Payment details","uniqueKey":"data.payment","typeLabel":"object"},"additionalData":{"type":"object","additionalProperties":true,"description":"Custom transaction data","uniqueKey":"data.additionalData","typeLabel":"object"},"status":{"type":"string","description":"Transaction status","enum":["APPROVED","DENIED","FAILED","PENDING"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"}},"description":"Record of a pass scan, purchase, or redemption.","isRequired":true,"uniqueKey":"data","typeLabel":"TransactionModel · object"},"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"description":"Response envelope carrying a transaction.","uniqueKey":"","typeLabel":"TransactionResponseModel · object"},"examples":{"Example":{"title":"Example","value":{"data":{"passId":"\u003cstring>","type":"PURCHASE","transactionDate":"2023-11-07T05:31:56Z","createdAt":"2023-11-07T05:31:56Z","id":"\u003cstring>","updatedAt":"2023-11-07T05:31:56Z","tapMode":"SINGLE_TAP","pointsSpent":123,"channel":"IN_STORE","instrument":"APPLE_VAS","remainingUsesBefore":123,"terminalId":"\u003cstring>","storeId":"\u003cstring>","reference":"\u003cstring>","pointsEarned":123,"statusReason":"\u003cstring>","remainingUsesAfter":123,"payment":{"reference":"\u003cstring>","amount":{"currency":"\u003cstring>","value":1},"method":"APPLE_PAY","pspReference":"\u003cstring>"},"additionalData":{},"status":"APPROVED"},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"abdd0590-a117-4b9a-97b8-56941ccadf68":{"description":"Missing required fields, invalid JSON, or terminalId does not belong to the specified storeId","content":{"application/json":{"schema":{"title":"Error400Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["BAD_REQUEST","VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"Invalid request parameters","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Bad request with validation details.","uniqueKey":"","typeLabel":"Error400Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"BAD_REQUEST","message":"Invalid request parameters","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"08898b9b-621c-47ee-bf6f-f53ddc874aac":{"description":"Authentication failed - invalid or missing API key","content":{"application/json":{"schema":{"title":"Error401Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["UNAUTHORIZED"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"Authentication required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Authentication failed.","uniqueKey":"","typeLabel":"Error401Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"UNAUTHORIZED","message":"Authentication required","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"611b9561-c4ce-4842-8882-9d79713021b2":{"description":"Pass belongs to a different company, or store belongs to a different company","content":{"application/json":{"schema":{"title":"Error403Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["FORBIDDEN"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"Access denied to this resource","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Access denied.","uniqueKey":"","typeLabel":"Error403Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"FORBIDDEN","message":"Access denied to this resource","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"ac8444cf-7c4c-4ac7-85b4-5d98bed55ea5":{"description":"Pass, store, program, merchant, or terminal not found","content":{"application/json":{"schema":{"title":"Error404Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["NOT_FOUND"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"Resource not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Resource not found.","uniqueKey":"","typeLabel":"Error404Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"NOT_FOUND","message":"Resource not found","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"ecc80e2f-6589-46ec-bc43-dcbbd3b892cc":{"description":"Internal server error","content":{"application/json":{"schema":{"title":"Error500Model","required":["error","requestId"],"type":"object","properties":{"requestId":{"pattern":"^[0-9A-Z]{26}$","type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","default":"An internal server error occurred","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error context","uniqueKey":"error.details","typeLabel":"object"}},"description":"Error information","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"description":"Internal server error.","uniqueKey":"","typeLabel":"Error500Model · object"},"examples":{"Example":{"title":"Example","value":{"requestId":"\u003cstring>","error":{"code":"INTERNAL_ERROR","message":"An internal server error occurred","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"29791f7e-3ba8-451e-af3c-3656b1eab42c":{"StellApiAuthorizer":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication. Include your API key as a Bearer token.\n\nExample: `Bearer sk_prod_xxxxxx`\n\nGet your API key from the Stell Dashboard.","scopes":[],"schemeName":"StellApiAuthorizer"}}},"servers":{"7cb07a26-83f2-4be3-9415-240d75b0dd81":{"url":"https://api.platform.getstell.com","description":"Production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication. Include your API key as a Bearer token.\n\nExample: `Bearer sk_prod_xxxxxx`\n\nGet your API key from the Stell Dashboard.","scopes":[],"schemeName":"StellApiAuthorizer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key authentication. Include your API key as a Bearer token.\n\nExample: `Bearer sk_prod_xxxxxx`\n\nGet your API key from the Stell Dashboard.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"StellApiAuthorizer","name":"Authorization"}],"title":"StellApiAuthorizer"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"stell","siteName":"Stell","title":"Create transaction - Stell","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T21:57:14.343Z","originalFileLocation":"api-reference/transactions/create-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=\"Record a new transaction against a pass.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Stell\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_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/stell/J93C2Sxezv9CfvWS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/stell/J93C2Sxezv9CfvWS/_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/stell/J93C2Sxezv9CfvWS/_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/stell/J93C2Sxezv9CfvWS/_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/stell/J93C2Sxezv9CfvWS/_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/stell/J93C2Sxezv9CfvWS/_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/stell/J93C2Sxezv9CfvWS/_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/stell/J93C2Sxezv9CfvWS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create transaction - Stell\">\u003cmeta data-mint-head property=\"og:description\" content=\"Record a new transaction against a pass.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Stell Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getstell.com/api-reference/transactions/create-transaction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://stell.mintlify.site/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Create+transaction\u0026amp;description=Record+a+new+transaction+against+a+pass.\u0026amp;theme=d920f5eee51ec1647d160b3e\u0026amp;signature=81b81e5e22a54afe38cc61c06fb2d8fe92f049bea36c9b850b4200ce44fe9ef7\">\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=\"Create transaction - Stell\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Record a new transaction against a pass.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://stell.mintlify.site/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Create+transaction\u0026amp;description=Record+a+new+transaction+against+a+pass.\u0026amp;theme=d920f5eee51ec1647d160b3e\u0026amp;signature=81b81e5e22a54afe38cc61c06fb2d8fe92f049bea36c9b850b4200ce44fe9ef7\">\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/stell/J93C2Sxezv9CfvWS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Stell\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getstell.com/api-reference/transactions/create-transaction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/transactions/create-transaction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://getstell.com/#organization\",\"name\":\"Stell\",\"legalName\":\"Stell Tech AS\",\"url\":\"https://getstell.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://getstell.com/brand/stell-wordmark-navy.svg\"},\"sameAs\":[\"https://www.linkedin.com/company/stell-tech-as/\",\"https://www.youtube.com/@getstell\",\"https://github.com/Stell-Tech\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getstell.com#website\",\"name\":\"Stell\",\"url\":\"https://docs.getstell.com\",\"publisher\":{\"@id\":\"https://getstell.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getstell.com/api-reference/transactions/create-transaction#webpage\",\"url\":\"https://docs.getstell.com/api-reference/transactions/create-transaction\",\"name\":\"Create transaction\",\"description\":\"Record a new transaction against a pass.\",\"dateModified\":\"2026-11-03T21:57:14.343Z\",\"isPartOf\":{\"@id\":\"https://docs.getstell.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getstell.com/api-reference/transactions/create-transaction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getstell.com/api-reference/transactions/create-transaction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transactions\",\"item\":\"https://docs.getstell.com/api-reference/transactions/get-transaction-details\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create transaction\",\"item\":\"https://docs.getstell.com/api-reference/transactions/create-transaction\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getstell.com/api-reference/transactions/create-transaction#apireference\",\"headline\":\"Create transaction\",\"name\":\"Create transaction\",\"description\":\"Record a new transaction against a pass.\",\"url\":\"https://docs.getstell.com/api-reference/transactions/create-transaction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getstell.com/api-reference/transactions/create-transaction#webpage\"},\"dateModified\":\"2026-11-03T21:57:14.343Z\",\"publisher\":{\"@id\":\"https://getstell.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getstell.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Stell\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Stell\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/transactions/create-transaction.md","siteName":"Stell","nav":{"global":null,"tabs":[{"tab":"Getting started","pages":[{"title":"Getting started","href":""}]},{"tab":"Merchant portal","pages":[{"title":"Merchant portal","href":"/programs/overview"}]},{"tab":"Launch \u0026 grow","pages":[{"title":"Launch \u0026 grow","href":"/launch-and-grow/overview"}]},{"tab":"API reference","groups":[{"group":"Essentials","pages":[{"title":"Stell API: issue Apple Wallet and Google Wallet passes","sidebarTitle":"Introduction","href":"/api-reference/introduction"},{"title":"Create and rotate Stell API keys","sidebarTitle":"API keys","href":"/api-reference/api-keys"},{"title":"Authenticate with the Stell API","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"Stell API errors and status codes","sidebarTitle":"Errors","href":"/api-reference/errors"}]},{"group":"Integration guide","pages":[{"title":"Wallet pass API integration guide","sidebarTitle":"Integration overview","href":"/api-reference/integration/overview"},{"title":"Add to Apple Wallet and Google Wallet from your own site or app","sidebarTitle":"Add to Wallet","href":"/api-reference/integration/add-to-wallet"},{"title":"Update a wallet pass from your backend","sidebarTitle":"Updating a pass","href":"/api-reference/integration/updating-passes"},{"title":"Identify wallet pass holders at the POS: scan or NFC tap","sidebarTitle":"In-store: scan or tap","href":"/api-reference/integration/in-store"},{"title":"Wallet pass webhooks, lifecycle and go-live checklist","sidebarTitle":"Webhooks and go-live","href":"/api-reference/integration/go-live"}]},{"group":"Webhooks","pages":[{"title":"Event webhooks for wallet pass events","sidebarTitle":"Event webhooks","href":"/api-reference/webhooks/overview"},{"title":"Webhook deliveries: payloads, retries and signature verification","sidebarTitle":"Webhook deliveries","href":"/api-reference/webhooks/deliveries"}]},{"group":"Passes","pages":[{"title":"Get pass transactions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/transactions","href":"/api-reference/passes/get-pass-transactions"},{"title":"Get pass details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}","href":"/api-reference/passes/get-pass-details"},{"title":"Void pass","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/passes/{passId}","href":"/api-reference/passes/void-pass"},{"title":"Update pass","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/passes/{passId}","href":"/api-reference/passes/update-pass"},{"title":"Generate Google Wallet save link","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/links/google","href":"/api-reference/passes/generate-google-wallet-save-link"},{"title":"Create pass image upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes/image-uploads","href":"/api-reference/passes/create-pass-image-upload"},{"title":"List passes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes","href":"/api-reference/passes/list-passes"},{"title":"Create new pass","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes","href":"/api-reference/passes/create-new-pass"},{"title":"Generate Apple Wallet installation link","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/links/apple","href":"/api-reference/passes/generate-apple-wallet-installation-link"},{"title":"Create secure Apple Wallet pass","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/apple/passes/secure","href":"/api-reference/passes/create-secure-apple-wallet-pass"},{"title":"Get pass registrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/registrations","href":"/api-reference/passes/get-pass-registrations"},{"title":"Batch create passes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes/batch","href":"/api-reference/passes/batch-create-passes"}]},{"group":"Pass Templates","pages":[{"title":"List all pass templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/templates","href":"/api-reference/pass-templates/list-all-pass-templates"},{"title":"Get program pass template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs/{programId}/templates/{templateId}","href":"/api-reference/pass-templates/get-program-pass-template"},{"title":"Delete program pass template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/programs/{programId}/templates/{templateId}","href":"/api-reference/pass-templates/delete-program-pass-template"},{"title":"Update program pass template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/programs/{programId}/templates/{templateId}","href":"/api-reference/pass-templates/update-program-pass-template"},{"title":"Get pass template details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/templates/{templateId}","href":"/api-reference/pass-templates/get-pass-template-details"},{"title":"List program pass templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs/{programId}/templates","href":"/api-reference/pass-templates/list-program-pass-templates"},{"title":"Create program pass template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/programs/{programId}/templates","href":"/api-reference/pass-templates/create-program-pass-template"}]},{"group":"Engagement","pages":[{"title":"Get pass geofences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/passes/{passId}/geofences","href":"/api-reference/engagement/get-pass-geofences"},{"title":"Replace all pass geofences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/passes/{passId}/geofences","href":"/api-reference/engagement/replace-all-pass-geofences"},{"title":"Add pass geofence","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/passes/{passId}/geofences","href":"/api-reference/engagement/add-pass-geofence"},{"title":"Delete all pass geofences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/passes/{passId}/geofences","href":"/api-reference/engagement/delete-all-pass-geofences"},{"title":"Delete pass geofence by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/passes/{passId}/geofences/{geofenceId}","href":"/api-reference/engagement/delete-pass-geofence-by-id"},{"title":"Update pass geofence by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/passes/{passId}/geofences/{geofenceId}","href":"/api-reference/engagement/update-pass-geofence-by-id"}]},{"group":"Programs","pages":[{"title":"Get encryption key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs/{programId}/encryption-key","href":"/api-reference/programs/get-encryption-key"},{"title":"List programs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs","href":"/api-reference/programs/list-programs"},{"title":"Create new program","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/programs","href":"/api-reference/programs/create-new-program"},{"title":"Get program details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/programs/{programId}","href":"/api-reference/programs/get-program-details"},{"title":"Delete program","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/programs/{programId}","href":"/api-reference/programs/delete-program"},{"title":"Update program","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/programs/{programId}","href":"/api-reference/programs/update-program"}]},{"group":"Companies","pages":[{"title":"List companies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies","href":"/api-reference/companies/list-companies"},{"title":"Get company details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies/{companyId}","href":"/api-reference/companies/get-company-details"}]},{"group":"Stores","pages":[{"title":"List stores","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/stores","href":"/api-reference/stores/list-stores"},{"title":"Create store","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/stores","href":"/api-reference/stores/create-store"},{"title":"Get store details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/stores/{storeId}","href":"/api-reference/stores/get-store-details"},{"title":"Delete store","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/stores/{storeId}","href":"/api-reference/stores/delete-store"},{"title":"Update store","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/stores/{storeId}","href":"/api-reference/stores/update-store"}]},{"group":"Merchants","pages":[{"title":"List merchants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/merchants","href":"/api-reference/merchants/list-merchants"},{"title":"Create merchant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/merchants","href":"/api-reference/merchants/create-merchant"},{"title":"Get merchant details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/merchants/{merchantId}","href":"/api-reference/merchants/get-merchant-details"},{"title":"Delete merchant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/merchants/{merchantId}","href":"/api-reference/merchants/delete-merchant"},{"title":"Update merchant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/merchants/{merchantId}","href":"/api-reference/merchants/update-merchant"}]},{"group":"Terminals","pages":[{"title":"Get terminal details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/terminals/{terminalId}","href":"/api-reference/terminals/get-terminal-details"},{"title":"Delete terminal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/terminals/{terminalId}","href":"/api-reference/terminals/delete-terminal"},{"title":"Update terminal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/terminals/{terminalId}","href":"/api-reference/terminals/update-terminal"},{"title":"List terminals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/terminals","href":"/api-reference/terminals/list-terminals"},{"title":"Create terminal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/terminals","href":"/api-reference/terminals/create-terminal"}]},{"group":"System","pages":[{"title":"JSON Web Key Set","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /.well-known/jwks.json","href":"/api-reference/system/json-web-key-set"},{"title":"Health check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/health","href":"/api-reference/system/health-check"}]},{"group":"Transactions","pages":[{"title":"Get transaction details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/transactions/{transactionId}","href":"/api-reference/transactions/get-transaction-details"},{"title":"List transactions","description":"List the company's transactions. passId, storeId and terminalId each narrow the list to one record's transactions; only one applies, with passId taking precedence over storeId and storeId over terminalId. A list narrowed that way reads oldest first; the company-wide list reads newest first. type, startDate and endDate combine with any of them.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Create transaction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/transactions","href":"/api-reference/transactions/create-transaction"}]}]}]},"basePath":"","title":"Create transaction - Stell","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}