Creating Gift Cards¶

This guide walks you through the process of creating tangible crypto gift cards using UniVoucher. You can create individual cards or multiple cards in bulk.

Prerequisites

Before creating a gift card, ensure you have:

A web3 wallet installed (like MetaMask, Coinbase Wallet, etc.)
The wallet connected to UniVoucher
Sufficient tokens for the card amount plus fees
Selected the correct network for your gift card

Creating a Single Gift Card¶

Step 1: Navigate to the Create Tab¶

Create Tab

Click on the "Create" tab in the main navigation bar.

Step 2: Select Token and Enter Amount¶

From the UniVoucher dashboard, click "Create Gift Card"
Choose the native token (like ETH, BNB, AVAX)
Or select an ERC-20 token from the list
You can also add a custom token by clicking "Custom" and entering the token address

Note

ERC-20 tokens require a one-time approval transaction before creating cards. You can approve a larger amount to avoid this step on future cards.

graph TD
    A[Start] --> B[Select Gift Card Token]
    B --> C[Native Token]
    B --> D[ERC-20 Token]
    D --> E[Approve Token Spend]
    C --> F[Create Card]
    E --> F
    style A fill:#f5f5ff,stroke:#6366f1,stroke-width:2px
    style F fill:#f0fff4,stroke:#6366f1,stroke-width:2px

Enter Amount

Enter Amount: Input the amount you want to add to the gift card

Your current balance is displayed below the input
The system automatically verifies you have sufficient balance (including fees)

Step 3: Set Quantity (Optional)¶

By default, the quantity is set to 1 for a single card. You can change this if you want to create multiple identical cards. For detailed instructions on creating multiple cards at once, see our Bulk Creation Guide.

Step 4: Add an Optional Message¶

Optional Message

You can add a public message that will be stored with the gift card on the blockchain (maximum 100 characters).

Step 5: Review and Create¶

Review and Create

Review the fee calculation details

Card Amount: The amount you specified
Protocol Fee: Calculated as 1% of the card amount
Total per Card: Amount + Fee

Click the "Create Gift Card" button

This will prompt your wallet to confirm the transaction

Confirm the transaction in your wallet

Click Create

For ERC-20 tokens, you may need to approve the token spending first
Then confirm the actual card creation transaction

Important

The transaction will need to be confirmed on the blockchain
Typical creation time: 15-60 seconds depending on network congestion
Keep your browser open until completion

Step 6: Secure the Card Details¶

Card Details

Once the transaction is confirmed, you'll see the gift card details:

Card ID: A unique identifier for the gift card
Card Secret: A 20-character secret in the format XXXXX-XXXXX-XXXXX-XXXXX

IMPORTANT

Save the card secret! It will not be shown again and cannot be recovered if lost.

Card Security

You can:

Copy both the Card ID and Secret
Download the card details as a text file
View the full card details including amount, network, etc.

Fees and Security¶

Fee Structure¶

UniVoucher charges a small fee for each card created: - The fee is 1% of the card amount - Paid in the same token as the card - Added to the transaction value

Security Best Practices¶

When distributing gift cards:

Share Securely: Send the card ID and secret through secure channels
Separate Messages: Consider sending the ID and secret through different channels
Avoid Public Sharing: Never share card secrets publicly
Verify Redemption: Ask recipients to confirm redemption
Cancel if Needed: You can cancel unredeemed cards if they were compromised

Abandonment Protection¶

To prevent permanent fund loss, All cards include an abandonment protection mechanism.

Abandonment Info

Abandonment process

Cards inactive for 5 years are considered abandoned
The abandonment date is displayed on the card details
Only after this period, the contract owner can intervene
This is a safety mechanism to prevent permanent fund loss
In normal circumstances, you can cancel unredeemed cards at any time