> ## 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.

# Quickstart

> Send USDC to anyone via a redeemable code. No SDK needed — just HTTP.

## 1. Get your API key

Go to [dashboard.chipipay.com](https://dashboard.chipipay.com), create an org, and copy your secret key from the Credentials page.

## 2. Create a gift code

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.chipipay.com/v1/gifts \
    -H "Authorization: Bearer sk_prod_YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "code": "WELCOME5",
      "name": "Welcome Bonus",
      "amount": 5,
      "token": "USDC",
      "chain": "STARKNET",
      "type": "GIFT_CARD",
      "maxRedeems": 100,
      "maxRedeemsPerUser": 1,
      "startsAt": "2026-01-01T00:00:00Z",
      "isActive": true
    }'
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch("https://api.chipipay.com/v1/gifts", {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk_prod_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      code: "WELCOME5",
      name: "Welcome Bonus",
      amount: 5,
      token: "USDC",
      chain: "STARKNET",
      type: "GIFT_CARD",
      maxRedeems: 100,
      maxRedeemsPerUser: 1,
      startsAt: new Date().toISOString(),
      isActive: true,
    }),
  });

  const gift = await response.json();
  console.log("Claim URL:", `https://dashboard.chipipay.com/claim/${gift.code}`);
  ```
</CodeGroup>

Credits are held from your org balance when you create the gift. They're consumed one-by-one as recipients redeem.

## 3. Share the claim link

Send your recipients this URL:

```
https://dashboard.chipipay.com/claim/WELCOME5
```

They'll see the gift amount, enter their wallet address, choose a chain, and claim — no account or app download needed.

<Tip>
  **Building wallet creation into your app?** Use the [@chipi-stack/chipi-passkey](/sdk/passkeys/overview) package to create self-custodial wallets with biometrics. Recipients get a wallet + their gift in one flow.
</Tip>

## 4. Or redeem via API

If you're building the redemption into your own app:

```bash theme={null}
# 1. Validate the code (show "You have $5 USDC!")
curl https://api.chipipay.com/v1/gifts/claim/WELCOME5

# 2. Redeem to a wallet
curl -X POST https://api.chipipay.com/v1/gifts/claim/WELCOME5/redeem \
  -H "Content-Type: application/json" \
  -d '{"walletAddress": "0x...", "chain": "starknet"}'
```

Starknet redeems are instant. Solana redeems take \~24 seconds via CCTP.

## 5. Buy credits

Gift card redeems debit from your org's credit balance. Buy a credit pack ($2 / $5 / $25 / $50 / \$100) at [dashboard.chipipay.com/configure/billing](https://dashboard.chipipay.com/configure/billing) by sending USDC.

## What you can build

| Use case                 | How                                    |
| ------------------------ | -------------------------------------- |
| User onboarding          | Airdrop \$5 USDC to new signups        |
| Referral rewards         | Give referrers a redeemable code       |
| Loyalty program          | Monthly USDC rewards for active users  |
| Promotional campaigns    | Bulk email 500 recipients via CSV      |
| Cross-chain distribution | Recipients claim on Starknet or Solana |

## Auth

| Method     | Header                              | Best for                                  |
| ---------- | ----------------------------------- | ----------------------------------------- |
| Secret key | `Authorization: Bearer sk_prod_...` | Server-side (create, list, manage)        |
| No auth    | None                                | Public claim endpoints (validate, redeem) |

<Warning>
  The claim endpoints (`/gifts/claim/:code/*`) are public — the code itself is the credential. Keep your gift codes as secret as you'd keep a password.
</Warning>

## Next

* [All endpoints](/services/gift-cards/endpoints) — create, validate, redeem, bulk, status
* [Cross-chain (CCTP)](/services/gift-cards/cross-chain) — how Starknet → Solana bridging works
* [Dashboard & bulk airdrop](/services/gift-cards/dashboard) — create + manage from the UI