Guides
Pickup
What happens at the counter, and how the pickup code works.
#At the counter
- The buyer goes to the shop once the order is ready.
- They say their pickup code.
- The shop enters it, and XEKTA charges the card at that moment. There is nothing to pay at the counter and the shop does not ring anything up.
#The pickup code
checkout_create returns the pickup_code. When pickup_code_withheld is true, the code is not in the tool result: the buyer finds it in their own XEKTA account at pickup_code_url.
- Show the code to the buyer once, right after checkout.
- Never paste a pickup code into feedback or anywhere else.
#Following the order
Ask the assistant for the status at any time; it calls user.orders.status. Each update is a ready-to-send sentence and is returned once. estimated_ready_at is the shop's ready time for that order, when the shop gave one.
#If the buyer left without giving the code
user_pickup_confirm records the buyer's own word.
| Call | Meaning |
|---|---|
Without picked_up | "I am at the counter." Kept as evidence if the handover is later disputed. |
picked_up: true | "I collected it." The order is charged now, the same as when the shop enters the code. |
picked_up: false | "I did not collect it," for an order the shop marked as handed over without the code. Nothing is charged, and XEKTA support reviews it. |
#After pickup
| Tool | Use |
|---|---|
user.delivery.confirm | The buyer got what they ordered. |
user.delivery.contest | Something was wrong or missing. There is a 24-hour window. |
#Orders that are not collected
Once the shop marks an order as being prepared or ready, it can no longer be cancelled for free. An order that is ready and not collected within the pickup window may be charged in full.