Event codes

Every event on a chain carries a stable code. Codes do not get renumbered — an auditor’s reading of an old chain must not change under them.

Voucher instance

code	event	meaning
VCH010	voucher.instance.claimed	minted to a holder
VCH011	voucher.instance.redeemed	used. the brand confirmed it gave the value
VCH012	voucher.instance.distributed	this row was handed on; the holder’s is a new row
VCH013	voucher.instance.voided	cancelled, or expired unused
VCH014	voucher.instance.transferred	handed person-to-person, no money
VCH020	voucher.supply.issued	a whole supply was issued (one event for the batch)

Hand-over links

code	event
VCH030	voucher.transfer.offered
VCH031	voucher.transfer.cancelled
VCH032	voucher.transfer.accepted
VCH033	voucher.transfer.expired

Redemption window

code	event	meaning
VCH040	voucher.redemption.reserved	held for a checkout; nothing spent
VCH041	voucher.redemption.released	given back unspent
VCH042	voucher.redemption.expired	nobody confirmed in time

Note

The confirmation itself is VCH011, the same code it has always been. “This voucher was used” is the same fact it always was; what changed in 2026-08 is who may assert it, and that is in the payload (ticket, externalRef, byPartnerKey).

A reserve-and-confirm in one act emits only VCH011 — one act, one event.