{"templateId":"markdown","versions":[{"version":"v1","label":"v1","link":"/api-reference/v1/components/docs/pos-transactions","default":true,"active":false,"folderId":"1b9c9f54"},{"version":"v2","label":"v2 (Beta)","link":"/api-reference/v2/components/docs/pos-transactions","default":false,"active":true,"folderId":"1b9c9f54"}],"sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Flute Developer","siteUrl":"https://developer.flute.com","description":"Documentation and API reference for integrating Flute payment processing.","lang":"en-US","llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"id":"payment-pos-transactions-overview"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["POS (point of sales) transactions represent payment transactions that are initiated and driven directly on a physical terminal device."," ","This is in contrast to transactions created purely through an API, such as a card-not-present charge."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A POS transaction is the record of a payment flow that runs through a physical terminal."," ","The point of service, such as a diner's table, creates it and enters at the terminal what to charge."," ","The transaction can then be polled or listed to see the resulting status and the core transaction."," ","The typical lifecycle that includes a POS transaction:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Creating one"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/pos/transactions"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","This initiates a transaction on a specific terminal device with predefined details."," ","These include the amount, transaction type, such as sale or authorization, currency, customer, pricing type, and whether to wait for the terminal to accept it."," ","The terminal handles the actual card read (readingMethod) and cardholder interaction."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tracking status"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","A POS transaction has its own lifecycle status (posTransactionStatus)."," ","This is such as TransactionProcessing or Completed and is separate from the underlying core transactionId it eventually links to once processed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listing them"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/pos/transactions"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","This returns a paginated list of POS transactions, filterable by terminalId, showing fields like processedAmount, transactionType, and the linked transactionId."]}]},"headings":[],"frontmatter":{"seo":{"title":""}},"lastModified":"2026-07-10T14:53:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/v2/components/docs/pos-transactions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}