Turn Bitcoin into shareable gift codes. Vouchers are redeemable payment links that let you distribute value without knowing recipients’ payment details – perfect for promotions, rewards, and re-engagement campaigns.

No User Details Needed

Send Bitcoin without knowing Lightning addresses or gamertags

Perfect for Marketing

Create bulk codes for promotions, giveaways, and campaigns

Track Everything

Monitor redemption rates and campaign performance

​
Why Use Vouchers?

​
🎁 User Acquisition & Retention

The Problem: Getting users to try your app is hard

The Solution: Give them immediate value

// Create welcome bonus vouchers
const voucher = await zbd.createVoucher({
  amount: 1000, // sats (~$0.50)
  description: "Welcome to GameApp! 🎮"
});

// Send via email/SMS
sendWelcomeEmail(user.email, voucher.code);

Result: 3x higher activation rates

​
🎯 Marketing & Promotions

Social Media Giveaways

  • Twitter/X campaigns: “RT to win!”
  • Discord events and contests
  • Twitch stream rewards
  • Community milestones

Event Marketing

  • Conference booth traffic
  • QR code scavenger hunts
  • Workshop attendance rewards
  • Beta testing incentives

Content Marketing

  • Survey completion rewards
  • Newsletter signup bonuses
  • Tutorial completion gifts
  • Review incentives

Partnership Campaigns

  • Co-marketing vouchers
  • Influencer distribution
  • Cross-promotion codes
  • Sponsor activations

​
Creating Vouchers

​
Dashboard Method

Navigate to Vouchers in your dashboard and click Create Voucher:

Create vouchers directly from the dashboard

​
API Method

// Single voucher
const voucher = await zbd.createVoucher({
  amount: 1000, // satoshis
  description: "Thanks for playing!"
});

console.log(`Share this code: ${voucher.code}`);
// Output: Share this code: ABC12345

// Bulk creation for campaigns
const campaign = await Promise.all(
  Array(100).fill(null).map(() => 
    zbd.createVoucher({
      amount: 500,
      description: "Launch week special"
    })
  )
);

​
Distribution Strategies

​
📧 Email Campaigns

<!-- Beautiful email template -->
<div style="text-align: center; padding: 20px;">
  <h2>You've received Bitcoin! 🎉</h2>
  <p>Redeem your gift with this code:</p>
  <div style="font-size: 32px; font-weight: bold; 
              background: #f0f0f0; padding: 20px; 
              border-radius: 8px; margin: 20px;">
    ABC12345
  </div>
  <p>Redeem now!</p>
</div>

​
🎮 In-App Distribution

// Trigger voucher creation on achievement
async function rewardAchievement(userId, achievement) {
  const voucher = await zbd.createVoucher({
    amount: achievement.rewardAmount,
    description: `Achievement unlocked: ${achievement.name}`
  });
  
  // Show in-game notification
  showNotification({
    title: "Achievement Unlocked! 🏆",
    message: `You earned ${achievement.rewardAmount} sats!`,
    code: voucher.code,
    action: "Tap to redeem"
  });
}

​
Redemption Process

​
For End Users

Quick Redemption (anywhere in dashboard):

  1. Open redemption modal inside Vouchers page
  2. Enter 8-character code
  3. Click “Redeem Voucher”
  4. Funds instantly added to wallet

​
API Redemption

// Programmatic redemption
const result = await zbd.redeemVoucher({
  code: 'ABC12345',
});

if (result.success) {
  console.log(`Redeemed ${result.amount} sats!`);
}

​
Managing Vouchers

​
Voucher Statuses

StatusDescriptionAction Available
🟢 ValidActive and redeemableShare, Revoke
✅ RedeemedSuccessfully claimedView details
❌ RevokedCancelled by creatorNone

​
Revoke Unused Vouchers

Cancel vouchers and reclaim funds:

// Revoke single voucher
await zbd.revokeVoucher(voucherId);

​
Best Practices

Set Expiration Dates

Create urgency and prevent long-term liabilities

Use Descriptive Names

Track campaign performance with clear descriptions

​
Advanced Use Cases

​
🎰 Gamified Redemption

// Mystery box vouchers with random amounts
function createMysteryVoucher() {
  const amounts = [100, 500, 1000, 5000, 10000];
  const random = amounts[Math.floor(Math.random() * amounts.length)];
  
  return zbd.createVoucher({
    amount: random,
    description: "Mystery Box 📦"
  });
}

​
Common Questions

​
Start Your First Campaign

1

Plan Your Campaign

Define goals, audience, and budget

2

Create Vouchers

Use dashboard or API for bulk creation

3

Distribute Codes

Email, social media, or in-app

4

Track Performance

Monitor redemption rates and adjust

Ready to Drive Engagement?

Start Creating Vouchers - Check out our API reference for programmatic voucher creation at scale.