Payouts and history
Collections, sweeps and gift-card delivery, and how to read the references.
Collections
A collector runs every minute. For every confirmed launch it reads the creator vault on the bonding curve (and, after graduation, on the DEX), collects whatever is there above the floor, and records a collection with the transaction signature.
The $2 minimum
Gift cards are sent in amounts of $2 or more. A collection only queues a card once the recipient's share of the vault reaches minPayoutUsd; smaller shares keep accruing across collections and go out the moment they cross $2. payoutFloorUsd is the vault value that triggers it and payoutReady says the card is queued for the next sweep.
Sweeps
Collected funds are swept to the treasury and converted to dollars. The sweep signature is attached to the collection and one payout is queued per route, according to its share.
Gift-card delivery
| Status | Meaning |
|---|---|
| pending | Queued from a collection, not yet processed. |
| processing | The card is being issued. |
| sent | Delivered. externalRef holds the reference. |
| failed | Delivery failed; it is retried and surfaced on the Payments page. |
References and receipts
Every delivered card carries a reference of the form IL-7K2Q-9M4X. It appears in the iMessage thread, on the Payments page and as externalRef on the payout record, so a recipient and the API always agree on which card is which.
Every gift card has a PDF receipt: open it from the Payments page or GET /v1/payouts/:id/receipt. It lists the issuer and recipient, the card as an item line, the total, the receipt number and the token the fees came from.
The Gift Flow page shows the whole pipeline live: fee claims, gift-card orders on G2G and the deliveries into Messages.