QrioTagQrioTag Docs
Flows & Examples

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:

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.

TimeOwnerWhat Happened
OriginalLisaLisa activated the tag on her bicycle
Day 1, 10:30 AMLisaLisa initiated transfer (OwnerTransfer PENDING)
Day 1, 2:22 PMTomTom 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?

Example: Transferring a Tag | QrioTag Docs