Quickstart

1. Get your API key

Go to dashboard.chipipay.com, create an org, and copy your secret key from the Credentials page.

2. Create a gift code

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
  }'

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}`);

Credits are held from your org balance when you create the gift. They’re consumed one-by-one as recipients redeem. 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.

Building wallet creation into your app? Use the @chipi-stack/chipi-passkey package to create self-custodial wallets with biometrics. Recipients get a wallet + their gift in one flow.

4. Or redeem via API

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

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

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.

All endpoints — create, validate, redeem, bulk, status
Cross-chain (CCTP) — how Starknet → Solana bridging works
Dashboard & bulk airdrop — create + manage from the UI

Gasless Wallets

Bill Payments

AI API

Gift Cards

Billing & Credits

1. Get your API key

2. Create a gift code

4. Or redeem via API

5. Buy credits

What you can build

Auth

Next

​1. Get your API key

​2. Create a gift code

​3. Share the claim link

​4. Or redeem via API

​5. Buy credits

​What you can build

​Auth

​Next

1. Get your API key

2. Create a gift code

3. Share the claim link

4. Or redeem via API

5. Buy credits

What you can build

Auth

Next