Appearance
Ownership-transfer flow (web)
A product's first claimant becomes its owner. Someone else who scans it can ask to take it over; the current owner approves, confirms with a one-time code, and the collectible moves. Two customers take part, so the player has a path for each.
Play the flow
shop.example.com/scan/7K2Q-9XPA
shop · rewards · scan
verified
Single Tin
owned by J***n — first owner
Page not designed yet — drawn from what the documented flow requires.
States
These are the journey's states. The rows behind them — firstowner, raised, accepted, rejected, and the owner level that climbs with each transfer — are drawn on Product ownership.
API calls by stage
| Stage | Who | API call | Access |
|---|---|---|---|
| 1 | New customer | POST /api/v1/user/verify/product/:authCode | Origin + Customer |
| 2 | New customer | POST /api/v1/brand/request/product/ownership — brl_id | Origin + Brand key + Customer |
| 3 | Owner | GET /api/v1/brand/product/ownership/:id — the id from the emailed link | Origin + Brand key + Customer |
| 4 | Owner | POST /api/v1/brand/approve-reject/product/ownership — id and exactly one of approve / reject | Origin + Brand key + Customer |
| 5 | Owner | POST /api/v1/brand/transfer/product/ownership — id, otp | Origin + Brand key + Customer |
| 6 | New owner | GET /api/v1/user/collectibles | Origin + Brand key + Customer |
What the API forces onto these pages
- The owner's page is
/collectible/ownership?token=…&id=…. The backend builds that link into the request email, so the storefront must serve the route. Thetokenis a customer token for the owner — the page can use it to make the owner's calls. - Approving does not transfer. It emails or texts the owner a code; only
transferwith that code moves the collectible. A page that stops after "approve" leaves the request armed and unfinished. - Two requests for the same product race. Once one is accepted at an owner level, approving another at that level is refused, and the requester must ask the new owner.
- The owner cannot start a transfer. On the storefront a transfer always begins with the new customer's request.