Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chipipay.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Dashboard overview

The Gift Cards dashboard at dashboard.chipipay.com lets you create, manage, and monitor gift codes without writing code. Navigate to your org → Gift Cards service → you’ll see three tabs:

​
Usage tab

Real-time metrics for your gift card activity:
  • Distributed ($) — total USDC sent to recipients
  • Redeemed — number of successful redemptions
  • **Fees Paid ()∗∗—totalredeemfees()** — total redeem fees (0.01 per redeem)
  • Codes Active — gift codes that are still redeemable
  • By chain — Starknet vs Solana breakdown
  • Recent redeems — table with wallet, chain, amount, status, and transaction link

​
Codes tab

All your gift codes in one table:
  • Utilization — progress bar showing redeems/maxRedeems
  • Status — Active, Expired, Exhausted, or Inactive
  • Copy link — one-click copy of the claim URL
  • Create Gift button — opens the create dialog

​
Integration tab

Code snippets for the full flow:
  1. Create a gift
  2. Validate a code
  3. Create wallet (if needed)
  4. Redeem to Starknet (instant)
  5. Redeem to Solana (CCTP)
  6. Poll cross-chain status

​
Creating a single gift

Click Create Gift in the Codes tab → Single mode:
FieldDescription
CodeCustom code (e.g. WELCOME5) or leave empty to auto-generate
NameHuman-readable name (e.g. “Welcome Bonus”)
AmountUSDC per redemption
Max RedeemsTotal number of times the code can be used
Recipient EmailOptional — sends a claim email to this address
After creating, the claim URL is copied to your clipboard automatically.

​
Bulk airdrop

Click Create Gift → Bulk Airdrop mode:
  1. Enter a campaign name (e.g. “May Airdrop”)
  2. Set the amount per recipient
  3. Upload a CSV file with an email column (optional code column for custom codes)
email,code
alice@example.com,
bob@example.com,BOB_SPECIAL
charlie@example.com,
  1. Preview the recipients and total cost
  2. Click Send N Gift Cards
Each recipient receives an email:
🎁 You received $5.00 USDC from Your App Name [Claim Your Gift]
The email links to dashboard.chipipay.com/claim/CODE — a public page where they enter their wallet address and claim.

​
Claim page

The claim page at /claim/CODE is public — no login, no app download, no API key needed. The flow for the recipient:
  1. Opens the claim link (from email, SMS, QR code, or social media)
  2. Sees the gift amount and sender name
  3. Enters their wallet address (Starknet or Solana)
  4. Chooses a chain
  5. Clicks Claim → USDC arrives in their wallet
Starknet: instant (~3 seconds) Solana: ~24 seconds via CCTP bridge

​
Costs

ActionCost
Create a giftFree (credits held, not spent)
Bulk create + emailFree (credits held, email via Resend)
Each redemption$0.01 flat fee + gift amount consumed from held credits
Delete unused giftFree (held credits released)
Validate / status pollFree
Cross-chain (Solana fast)~$0.01 additional CCTP fee

​
Limits

Admins can set per-org limits:
LimitDescriptionDefault
Max value per codeMaximum USDC amount per giftNo limit
Monthly capMaximum USDC distributed per monthNo limit
Redeem feeFee per redemption$0.01
These are configured by the Chipi admin. Contact support to adjust.

​
Compliance

Gift card distributions may be subject to money transmission, KYC, and tax reporting requirements in your jurisdiction. Chipi collects the following data for compliance purposes:
  • Recipient wallet address
  • Destination chain
  • IP address (retained for 90 days)
  • Transaction hashes (permanent)
  • Redeem fees (permanent)
Compliance flags are generated automatically for:
  • Single gifts > $100
  • Org distributions > $1,000/month
  • Cross-chain transfers > $50
  • Same wallet redeeming > 5 times in 7 days
These flags are reviewed by the Chipi compliance team and do not block redemptions.