Track gift-card orders
Know exactly what you bought and what's left: an order's fulfilment status and a pool's live inventory of available, reserved, and redeemed cards.
After you place a gift-card order, fulfilment happens asynchronously — the cards don't all appear the instant you pay. Both views live in the Paylode admin app, alongside where you placed the order.
How it works
Two things are worth reading, and they answer different questions:
- An order answers "did my purchase go through, and how many cards did I get?" It carries a lifecycle status and the fulfilled count.
- A pool answers "how much inventory do I have left?" It carries a live snapshot of available, reserved, and redeemed cards per denomination.
Orders are non-cancellable and funded only from your wallet — there's no card-on-file fallback — so tracking is how you reconcile spend against inventory after the fact.
An order's lifecycle
Each order in the app shows where it is on this path:
| Status | Meaning |
|---|---|
PLACED | Wallet debit succeeded; the order is awaiting fulfilment. |
PROCESSING | Fulfilment is in flight. |
COMPLETED | Fulfilment finished and at least one card landed in the pool. |
DECLINED | Zero cards were issued. A refund is owed (see below). |
COMPLETED and DECLINED are the settled states — an order always ends in
one of them.
Partial fulfilment
A completed order isn't always a fully fulfilled one. Compare the two counts
the order shows: how many cards you requested versus how many were
actually fulfilled. A shortfall doesn't get its own status — the order
still reads COMPLETED, the difference is in the counts, and the shortfall is
refunded.
Refunds
The order's refund state is separate from its lifecycle status and tells you whether money is coming back:
| Refund state | Meaning |
|---|---|
NONE | Nothing owed — the order fulfilled in full. |
PENDING | A refund is owed (a partial fulfilment or a DECLINED order) and is being processed. |
COMPLETED | The refund has been returned to your wallet. |
FAILED | A refund attempt didn't go through; Paylode is retrying it. |
Refunds are processed for you — there's nothing to do; the amount and time show on the order once it completes.
A pool's inventory
The pool view is a live snapshot, one row per denomination/currency/country. Three counts tell the whole story:
| Count | Meaning |
|---|---|
| Available | Cards on hand, ready to hand out as a reward link. |
| Reserved | Cards bound to a reward link that hasn't been revealed yet. If a link expires, its card moves back to available. |
| Redeemed | Cards a recipient has revealed. Terminal. |
Reserving a card (Share gift-card reward links) moves it from available to reserved; a reveal moves it from reserved to redeemed. If a pool backs a Boost incentive, watch its available count — a dry pool stops serving that reward.
Troubleshooting
Orders can't be cancelled. If an order is heading somewhere you didn't
intend, you can't stop it — but a DECLINED or partially fulfilled order is
refunded automatically, so you're never charged for cards you didn't receive.
A short wallet stops the order before it starts. Because there's no
card-on-file fallback, an order against an underfunded wallet fails at
placement — it never reaches PLACED, and nothing is charged. See
Order gift cards.
Related
- Gift Cards overview — what the product does and how this page fits it.
- Order gift cards — place the orders you're tracking
- Share gift-card reward links — hand cards out of a pool
- Gift card — the concept behind the inventory.