← API Index

Donations and Tip

Shop operators can configure special items — such as a tip for the driver or a charitable donation — that customers may add to their order. These items may be handled specialin an online shop.

These donation items have item type 78 and follow a few special rules described here.

Key rules

1. Discover the configured donation items

Call /api/configuration40. The returned Config object contains

2. Load the item details

Fetch the items by id with

GET .../api/itemlist19?hidden=1&i=<comma separated ids>

Pass hidden=1 so you also receive donation items the operator chose to hide from the regular shop. The response contains regular Item objects; use name and the item image (if any) to render the donation buttons. Expect type = 78 on these items.

3. Present them in the cart

The standard shop shows one button per donation item in the cart's action area:

3a. It's a regular item — the button is only a shortcut

A donation item is a fully generic Item; the suggested-button flow above is just one convenient way to add it, not the only one. Once a donation item is visible (not hidden, or you deliberately surface it), your implementation may instead let the customer:

4. Submit the order

No special handling is needed.

The stored position appears like any other position in subsequent /api/order28 responses; identify it by its type 78 to keep rendering a disclaimer/Icons and to skip availability checks for it.