[Feature Request] Support for Terminal Transaction Webhooks
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- openapi
- Domain
- api, backend-api-design
Research direction
Start by reviewing the OpenAPI specification's webhook definitions and the /transactions/history endpoint referenced in the issue. Compare existing checkout webhook events with terminal transaction data, then define the event and payload needed for successful physical-terminal transactions. Done means the specification documents the new event and its transaction, receipt, and line-item fields.
Written by the indexing model from the issue text.
Description
Currently, the OpenAPI specification and the Webhook implementation seem to be focused on checkouts (Remote/Online Payments). For developers building e.g. a Kitchen Display Systems or real-time inventory trackers for physical points of sale (eg. using Solo), there is no push-notification for successful terminal transactions.
We are currently forced to poll the /transactions/history endpoint every few seconds to detect new sales. This is inefficient for both our infrastructure and SumUp's API performance.
I would like to request a new webhook event type, for example transaction.successful or receipt.created, that triggers as soon as a physical terminal transaction is completed.
The payload should ideally include:
- transaction_id
- amount
- currency
- status
- tip
- Link to the receipt_data or the included line items.
- products
Real-time capability is crucial for hospitality and catering environments (e.g., "McDonald's style" order number displays). Adding this to the OpenAPI spec would allow a much broader range of automation tools to be built on top of the SumUp ecosystem.
- Dominant language
- No language data
- Stars
- 6
- Forks
- 0
- Avg merge
- 3d 13h
- Merged PRs (30d)
- 1
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Similar issues
-
bug clawsweeper:linked-pr-open clawsweeper:needs-live-repro clawsweeper:no-new-fix-pr impact:message-loss issue-rating: 🐚 platinum hermit P2 regression
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
AXERA-TECH/ax-llm#77 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
games-on-whales/wolf#509 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100