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
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
1Submit serials
Upload the serial list (CSV or API) bound to the target product or batch.
2Validate
The validator returns accepted serials, rejected serials, and the reason for each rejection.
3Mint
Accepted serials are minted as the unit identifier for the resulting passports.
4Issue carriers
Carrier outputs (QR codes, NFC payloads) are produced against the BYO serials and made available
through the export pipeline.