> ## 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 & Bulk Airdrop

> Create gift codes, send bulk emails, and manage campaigns from the dashboard — no code needed.

## Dashboard overview

The Gift Cards dashboard at [dashboard.chipipay.com](https://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 ($)** — 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:

| Field           | Description                                                   |
| --------------- | ------------------------------------------------------------- |
| Code            | Custom code (e.g. `WELCOME5`) or leave empty to auto-generate |
| Name            | Human-readable name (e.g. "Welcome Bonus")                    |
| Amount          | USDC per redemption                                           |
| Max Redeems     | Total number of times the code can be used                    |
| Recipient Email | Optional — 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)

```csv theme={null}
email,code
alice@example.com,
bob@example.com,BOB_SPECIAL
charlie@example.com,
```

4. Preview the recipients and total cost
5. 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

| Action                    | Cost                                                         |
| ------------------------- | ------------------------------------------------------------ |
| Create a gift             | Free (credits held, not spent)                               |
| Bulk create + email       | Free (credits held, email via Resend)                        |
| Each redemption           | **\$0.01 flat fee** + gift amount consumed from held credits |
| Delete unused gift        | Free (held credits released)                                 |
| Validate / status poll    | Free                                                         |
| Cross-chain (Solana fast) | \~\$0.01 additional CCTP fee                                 |

***

## Limits

Admins can set per-org limits:

| Limit              | Description                        | Default  |
| ------------------ | ---------------------------------- | -------- |
| Max value per code | Maximum USDC amount per gift       | No limit |
| Monthly cap        | Maximum USDC distributed per month | No limit |
| Redeem fee         | Fee 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.