Purchase history and transaction details
Look up purchase intent ID by Adyen session ID (stored in psp_request_ref). Used when Adyen redirects back with sessionId but no purchaseIntentId in URL.
Permissions: 🔵 purchases.read
path Parameters
sessionIdAdyen session ID (psp_request_ref)
query Parameters
locationIdLocation ID for permission validation
Responses
Purchase intent found for session
statusList purchases with automatic BigQuery routing for historical data
query Parameters
locationIdLocation ID to filter purchases (required for permissions)
startDateStart date for date range filter (ISO 8601)
endDateEnd date for date range filter (ISO 8601)
userIdFilter by user ID
minAmountMinimum amount in cents
maxAmountMaximum amount in cents
minRefundedAmountMinimum refunded amount in cents
maxRefundedAmountMaximum refunded amount in cents
paymentMethodFilter by payment method
statusFilter by payment status
customerEmailFilter by customer email (partial match)
itemIdFilter purchases containing a specific inventory item ID
tableIdFilter by table/storefront QR code UUID
tabIdFilter by tab UUID
tabTypeFilter by tab type (comma-separated: takeaway, over_the_counter, table)
pagePage number for pagination
limitNumber of results per page (max 1000)
Responses
Purchases retrieved successfully
statusFetch cash register info from cash-register service for a purchase that has a receipt ID but missing other cash register fields. Used to backfill data for older purchases.
Permissions: ⚪ purchases.write
path Parameters
purchaseIntentIdPurchase intent UUID
query Parameters
locationIdLocation ID for permission validation
Responses
Cash register info fetched successfully
statusRegister a purchase with the cash register service (efterregistrering). Used for purchases that were not registered at the time of payment. Location must have an active cash register configuration.
Permissions: ⚪ purchases.write
path Parameters
purchaseIntentIdPurchase intent UUID
query Parameters
locationIdLocation ID for permission validation
Responses
Purchase registered with cash register successfully
statusConnect a customer to a purchase by email. Optionally enroll in loyalty and award retroactive points.
path Parameters
purchaseIntentIdPurchase intent UUID
query Parameters
locationIdLocation ID for permission validation
Request Body
emailCustomer email address (used to find or create user)
nameCustomer name (optional, used to update user profile)
phoneCustomer phone number (optional)
enrollInLoyaltyEnroll customer in location loyalty program and award retroactive points
Responses
Customer connected successfully
statusSend a receipt email copy to a specified email address.
Validates the purchase is confirmed, then triggers the receipt email Cloud Function via PubSub. The email uses the same template as automatic storefront receipt emails.
path Parameters
purchaseIntentIdThe purchase intent ID
Responses
Receipt email send initiated
statusGet unified order purchase details by purchase intent ID (matches storefront-web format)
path Parameters
purchaseIntentIdPurchase intent UUID
query Parameters
locationIdLocation ID for permission validation
Responses
Order purchase details retrieved successfully
statusUnified order purchase data (matches storefront-service response format)
Get receipt data for email generation with hierarchical line items
path Parameters
purchaseIntentIdPurchase intent UUID
query Parameters
locationIdLocation ID for permission validation
Responses
Receipt email data retrieved successfully
statusReceipt email data with hierarchical line items
Render a purchase receipt as Adyen terminal OutputText for printing. Proxies to printer-service.
Permissions: 🔵 purchases.read
path Parameters
purchaseIntentIdPurchase intent UUID
query Parameters
locationIdLocation ID for permission validation
Responses
Adyen OutputText payload ready to ship in a Nexo PrintRequest envelope
statusGet a single purchase by intent ID (UUID)
path Parameters
intentIdPurchase intent ID (UUID)
query Parameters
locationIdLocation ID for permission validation
Responses
Purchase retrieved successfully
status