# Dynamic products issuance

Version

This page is for the Client API v2. For the Client API v3 documentation, please see the issue vouchers page.

Dynamic value-based products can be issued for denominations ranging from $1 to $1000.

Tip

The API and product definition doesn't enforce limits other than the $1 to $1000 range of denominations. Clients may limit on their side what can be issued by users.

Dynamic products can be identified in catalogues from the product name containing ${FV} (FV for face value) instead of a specific denomination.

The issuance of dynamic products follows the Request Vouchers process with the addition of the face value parameter in the request body.

# Issuance of `${FV} UNIQGIFT Groceries Voucher` with a denomination of $50

# Request body

{
  "manual_quantity": 1,
  "distribution_mode": "manual",
  "face_value": 50.00
}

face_value: face value of 50.00 for $50

Tip

Dynamic vouchers are not limited to full dollar amounts. A typical use-case is to convert a stock of available rewards points to a voucher (for instance 12345 points converted into a $61.72 voucher)

# Response body

{
    "meta": {
        "status": "succeeded"
    },
    "data": [
        {
            "voucher_ref": "UG2884133732",
            "voucher_settlement_ref": "9e76222b-0ff8-48f5-9635-63706d1b9c3f",
            "voucher_name": "$50 UNIQGIFT Groceries Voucher",
            "status": "Active",
            "expiration_date": "2029-12-31T23:59:59",
            "edenred_url": "https://s.ticketxpress.sg/v/AMJSHc0M2d0",
            "view_code": "2708",
            "display_codes": []
        }
    ]
}

voucher_name: note the voucher name issued containing the issued voucher denomination.

← Check Vouchers Issue recovery using idempotency →