Minting

Bring-Your-Own Serials

Bring-Your-Own (BYO) Serials lets brands mint passports against serial numbers that are generated outside tieback — for example, serials issued by a factory MES, an existing ERP system, or a partner’s pre-printed inventory.

When to Use BYO Serials

ScenarioUse BYO Serials?
Brand has no existing unit identification schemeNo — let tieback generate serials
Brand has an existing serial scheme they want to preserveYes
Pre-printed labels with externally generated serials need to be activatedYes
Compliance regime mandates a specific serial formatYes

Validation

Submitted serials are validated before mint:

  • Format — characters and length must match the configured pattern
  • Uniqueness — serials must be unique within the brand’s namespace
  • Capacity — submission size must be within the per-batch ceiling defined by the active plan

Validation runs synchronously for small submissions and asynchronously for large submissions, with row-level error reporting.

Mint Flow

1

Submit serials

Upload the serial list (CSV or API) bound to the target product or batch.

2

Validate

The validator returns accepted serials, rejected serials, and the reason for each rejection.

3

Mint

Accepted serials are minted as the unit identifier for the resulting passports.

4

Issue carriers

Carrier outputs (QR codes, NFC payloads) are produced against the BYO serials and made available through the export pipeline.