Voucher

https://publicschema.org/Voucher

draft

A redeemable instrument issued to a beneficiary as fulfillment of a benefit entitlement. A voucher has a distinct lifecycle: creation, issuance, redemption, expiry, or cancellation. It may be electronic (digital code, SMS, QR) or paper. Multiple vouchers may fulfill a single entitlement, and a voucher's face value may differ from the entitlement amount.

JSON-LD JSON Schema CSV Definition (Excel) Template (Excel)

Properties

Property Type Definition
Entitlement reference uri Reference to the entitlement that this payment or voucher fulfills.
Issued to concept:Party includes Person, Group, Household, Family, Farm
The party (person, household, or group) to whom the document, voucher, or credential is issued.
Redeemable by concept:Party includes Person, Group, Household, Family, Farm
The person or group authorized to redeem this voucher on behalf of the beneficiary.
Serial number string
A public identifier for the voucher, printed on the physical document or communicated via SMS or application.
Amount decimal
The monetary or quantitative value of the item being delivered, owed, or redeemed, expressed as a decimal number in the associated currency.
Currency string (currency) The ISO 4217 currency code for a monetary value.
Voucher status string (voucher-status) The lifecycle state of the voucher.
Voucher format string (voucher-format) The physical or digital form of the voucher.
Issue date date The date on which this record or document was issued.
Expiry date date The date on which this record or document expires or becomes invalid.
Redemption date date The date on which the voucher was redeemed at a vendor or agent.
Redeemed by concept:Person The person who presented the voucher for redemption.
Redemption agent string The merchant, vendor, or agent who accepted the voucher for redemption.
Items concept:DeliveryItem The list of commodity line items in this delivery or voucher.

Evidence

Not yet found in mapped delivery systems.

None of the six currently mapped SP systems model vouchers as standalone entities. GovStack Payments Building Block (a specification, not a mapped system) models vouchers as first-class entities with a full lifecycle API. Voucher-based delivery is common in humanitarian programs (WFP SCOPE, UNICEF RapidPro). Expect gap-heavy SSSOM mappings initially.

Referenced by this concept

See full reference catalogue