Results & winning prizes
Show draw results and help a winner take the next step.
Display draw results
Listen for raffle.drawn, then refresh the raffle detail. Show the winning ticket, prize and public winner name when available.
winner_external_user_ref identifies one of your own buyers. It is null when the winner belongs to another storefront. A draw result is not itself confirmation that prize delivery has finished.
Notify your winner
Use prize.won to notify the buyer that their prize is ready. In Verity-collected mode, the existing prize NFT has been delivered to the wallet used for the winning payment.
Refresh GET /users/{externalUserRef}/prizes to show the buyer's prize history. The list includes past redeemed and bought-back prizes, not just items currently available for shipping.
| Field | How to use it |
|---|---|
prize_item | Name, description, images and value |
mint_address | Link to the NFT on the appropriate explorer |
redeemable | Whether to offer the shipping flow; quote/prepare recheck wallet ownership |
redeem_blocked_reason | Explain why shipping is not currently available |
redemption | Existing shipping order and tracking details |
There is no Keep Item or Mint button to implement. The item is already minted. can_ship_now is retained for compatibility; use redeemable for new integrations.
Buyback availability
Partner buyback is currently unavailable. Hide the action when buyback.available or buyback.eligible is false. A non-null amount or expiry does not make an offer actionable.
Offer shipping
You can direct winners to Verity to arrange shipping with the same wallet, or build the optional wallet redemption flow into your storefront.
If you display draw proof, use the provider and proof returned by the API. A mock provider is test randomness; do not label it a verified on-chain draw.