Example: Transferring a Tag
How to transfer QrioTag ownership from one user to another — step by step with API calls.
What this example shows
This walkthrough covers the full tag transfer flow: initiating a transfer, the email invitation, code acceptance, profile handoff, and what changes for each party — so a tag can move with an item when it is sold or gifted.
This example follows Lisa, who sells her bicycle (with a QrioTag Bike Tag) to Tom. Instead of buying a new tag, they transfer the existing tag to Tom's account.
The Characters
Lisa
Current owner of a bicycle with a QrioTag Bike Tag.
Tom
Buyer of Lisa's bicycle. Has a QrioTag account.
Step 1: Lisa Decides to Transfer the Tag
Lisa is selling her bicycle to Tom. The bike has a QrioTag Bike Tag attached to the frame that Lisa activated when she first bought the bike. Rather than removing the tag and wasting it, Lisa decides to transfer ownership to Tom.
Step 2: Lisa Initiates the Transfer
Lisa goes to her QrioTag dashboard, finds the bike tag, opens its settings, and taps "Transfer Tag."
She enters:
- Recipient email: tom@example.com
- Reason: Sold bicycle
Transfer codes are single-use
Each transfer code can only be used once. If the transfer expires or is cancelled, a new transfer must be initiated to generate a fresh code.
Step 3: Tom Receives the Transfer Email
Tom gets an email from QrioTag:
Subject: QrioTag Transfer Request
Hi Tom,
Lisa has transferred a QrioTag to you.
Tag: QRIO-D2P7K4M9 (QrioTag Bike Tag)
Item: Lisa's Trek FX 3 Bicycle
Reason: Sold bicycle
To accept this transfer, log in to your QrioTag account
and enter this transfer code:
XFR-7K4M-9N2P-B8C3
This code expires on April 15, 2026.
If you were not expecting this transfer, you can ignore
this email.Step 4: Tom Accepts the Transfer
Tom logs in to his QrioTag account, goes to the Tags section, and taps "Accept Transfer." He enters the transfer code from the email.
Step 5: Lisa Sees the Tag is Gone
Lisa opens her QrioTag dashboard. The bike tag is no longer in her list of tags. She sees a notification:
"Transfer complete: Your tag QRIO-D2P7K4M9 has been transferred to tom@example.com."
Lisa no longer has any access to the tag, its profile, scan history, or messages.
Step 6: Tom Updates the Profile
Tom now owns the tag. He goes to the tag settings and updates the profile with his own information.
The tag is now fully Tom's — registered to his account, with his profile data, counting toward his tag limit.
The Complete Status Journey
ACTIVE (Lisa) → ACTIVE (Tom)Ownership transfers atomically via the OwnerTransfer record. The tag status stays ACTIVE throughout — only the ownerId changes.
| Time | Owner | What Happened |
|---|---|---|
| Original | Lisa | Lisa activated the tag on her bicycle |
| Day 1, 10:30 AM | Lisa | Lisa initiated transfer (OwnerTransfer PENDING) |
| Day 1, 2:22 PM | Tom | Tom accepted; OwnerTransfer ACCEPTED, ownerId changed |
Transfer Rules and Edge Cases
What if Tom does not have a QrioTag account?
Tom will need to create an account first. The transfer email includes a link to register. Once Tom has an account, he can accept the transfer using the code.
What if the transfer expires?
If Tom does not accept within 7 days, the transfer is automatically cancelled. The tag stays with Lisa. Lisa can initiate a new transfer if needed.
What if Lisa wants to cancel the transfer?
Lisa can cancel a pending transfer before Tom accepts it. The tag stays with Lisa and the transfer code is invalidated.
Can Lisa transfer a LOST or STOLEN tag?
No. Only tags in ACTIVE or DEACTIVATED status can be transferred. If a tag is in LOST or STOLEN status, the owner must first change it back to ACTIVE before initiating a transfer.
Does the transfer preserve scan history?
The scan history stays with the tag but is only visible to the current owner. Lisa loses access to the scan history once the transfer is complete. Tom can see scans that occurred both before and after the transfer.
Is there a limit to how many times a tag can be transferred?
No. A tag can be transferred as many times as needed. Each transfer creates an audit log entry, so the full ownership history is preserved for administrators.
Transfers are permanent
Once Tom accepts the transfer, there is no "undo" button. If Tom wants to give the tag back to Lisa, he would need to initiate a new transfer in the opposite direction.
Was this page helpful?