Integration Guide¶
Welcome to UniVoucher. This guide walks you through everything you need to know to get started issuing and selling UniVoucher gift cards.
Getting Started¶
UniVoucher is a fully decentralized, open protocol. There are no contracts to sign, no waiting periods, and no pre-approval or official verification required. You can begin issuing and selling UniVoucher gift cards immediately.
Importantly, you will not be a reseller. You will be a direct, first-hand issuer of the gift cards, which gives you full control over your pricing and margins.
About UniVoucher¶
UniVoucher allows anyone to create crypto gift cards using any ERC-20 token — including USDT, USDC, and others — in any amount, across 7 EVM-compatible blockchain networks:
- Ethereum
- Base
- BNB Chain
- Polygon
- Arbitrum
- Optimism
- Avalanche
Fee Structure¶
The fees are straightforward and transparent:
| Fee | Amount |
|---|---|
| Card creation fee | 1% of the card's token value |
| Gas fee | ~$0.01 per transaction |
| Redemption fee | None |
| Monthly / setup / hidden fees | None |
You set your own retail price on top of that. Everything is on-chain and fully transparent.
How to Create Gift Cards¶
There are a few ways to integrate, depending on how you want to operate.
1. Manual Creation via univoucher.com¶
The quickest way to get started. Connect your Web3 wallet and you can create single cards or bulk batches immediately — no sign-up required.
This works well for pre-stocking cards that are ready to deliver once a customer places an order.
2. On-Demand Creation via Direct Smart Contract Integration¶
This lets you create a card only after a customer places an order, with no need to pre-stock inventory. You implement a creation function in your backend using the ethers.js library, the UniVoucher contract ABI, and an Alchemy RPC endpoint. Your pre-loaded Web3 wallet handles the transaction automatically.
This is ideal for automated, programmatic card issuance at scale.
For technical implementation details, see the Smart Contract documentation and API Reference.
3. On-Demand Creation via UniVoucher Public API¶
If you prefer not to handle the smart contract layer directly, the UniVoucher public API endpoint handles that for you and sends a callback with the creation status.
- Completely free
- No API key required
- No prior approval needed
Full API specification is available at api.univoucher.com.
WooCommerce Plugin¶
If your store runs on WooCommerce, there is an official plugin available on the WordPress Plugin Directory. Search for "UniVoucher for WooCommerce".
The plugin supports:
- Pre-stocked and on-demand card creation
- Instant digital delivery
- Bulk CSV uploads
- Card verification
- Promotional cards
- And more
See the WooCommerce Plugin documentation for setup instructions.
Partner Program¶
If you operate a wallet, crypto app, or any platform where users redeem gift cards, you can participate in the UniVoucher Partner Program.
As a partner, you earn a 1% fee from every card redeemed through your platform. This fee is deducted from the card amount and sent directly to your address at the time of redemption — no invoicing or manual payouts required.
For example, a 100 USDC card redeemed through your platform:
- You (partner) receive: 1 USDC
- Card recipient receives: 99 USDC
There is no approval process to become a partner. You simply pass your wallet address as the partner parameter during the redemption transaction. For technical details, see the Smart Contract documentation.
Next Steps¶
The simplest way to get a feel for the process is to:
- Visit univoucher.com and connect your Web3 wallet
- Create a test card to see how the process works end to end
- Explore the full documentation at docs.univoucher.com and choose the integration method that fits your setup
We are happy to assist with any part of the process — whether that is the technical integration, plugin setup, or any questions along the way.