Skip to main content

​
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
  }'
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.
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/2 / 5 / 25/25 / 50 / $100) at dashboard.chipipay.com/configure/billing by sending USDC.

​
What you can build

Use caseHow
User onboardingAirdrop $5 USDC to new signups
Referral rewardsGive referrers a redeemable code
Loyalty programMonthly USDC rewards for active users
Promotional campaignsBulk email 500 recipients via CSV
Cross-chain distributionRecipients claim on Starknet or Solana

​
Auth

MethodHeaderBest for
Secret keyAuthorization: Bearer sk_prod_...Server-side (create, list, manage)
No authNonePublic 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.

​
Next