Skip to main content
An order is a request to buy one or more of your products. This page follows an order all the way through, so you know what each stage means and when keys actually change hands.

Where orders come from

Orders can start in three ways, and they all end up in the same place once they arrive.

Manual entry

You create the order yourself, for example after a sale made off-platform.

Your storefront

A buyer places the order on your store’s own page.

A sales channel

A connected marketplace sends the order to you automatically.

From order to delivered key

1

The order arrives

A new order is recorded as Pending with what was bought, by whom, and for how much. It moves to Reserved once keys are held for it, so they cannot be sold to anyone else.
2

Fulfilment issues the keys

When the order is delivered, the reserved keys are marked Sold and issued to the order, which moves to Delivered. This is the moment stock is actually spent.
3

A private delivery link is created

The buyer’s delivery page is prepared and a private link is created for it. This link does not exist until delivery happens, so an order that has not been delivered has no delivery page yet.
4

The buyer collects and reveals

The buyer opens their link, reveals their keys, and can download an invoice. Once every key on the page has been revealed, the order moves to Completed on its own. You can also select Mark as Completed on a delivered order to close it yourself.
The private delivery link is created at delivery time, not when the order is placed. That is why you only see the link on an order after you have delivered it.

Sales a channel already delivered

Some channels deliver the keys themselves at checkout. TokenSupply records each such sale as one order that arrives already paid and Completed. It skips the reserve and deliver steps above, because the keys have already changed hands. A delivery page is created only when the channel tells TokenSupply which keys it handed over.

When an order does not complete

Not every order ends in a delivery. These outcomes handle the rest.
A refunded order returns money to the buyer. This is used when the sale needs to be reversed after delivery. Refunding revokes the buyer’s delivery link straight away, and the order’s keys are released back to your stock after 15 minutes.
A cancelled order is stopped before it is delivered. Any keys held for it are released back into your stock so they can be sold again.
Deleting an order takes it off your lists. An order that was never delivered is removed and its reserved keys are released. A delivered order keeps its record behind the scenes, so its keys stay Sold and traceable and the buyer’s link keeps working. See Delete an order.

Create an order

Enter an order by hand.

How fulfilment works

Deliver keys to a buyer step by step.

The delivery portal

What the buyer sees when they collect their keys.

Delivery and custom domains

How delivery pages are hosted and kept private.