Skip to main content

Coupon Codes

Coupon codes give you free credits. ACN distributes them for launch promotions, beta programs, partner integrations, and support resolutions.

Redeem from the Dashboard

  1. Go to Billing in the left sidebar
  2. Click Redeem Coupon
  3. Enter your coupon code (case-insensitive)
  4. Click Apply — credits are added instantly

Redeem via API

curl -X POST https://api.acn.exchange/v1/billing/coupons/redeem \
  -H "Authorization: Bearer acn_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "LAUNCH50"
  }'
Success response:
{
  "code": "LAUNCH50",
  "creditsGranted": "50000000",
  "usdcEquivalent": "50.000000",
  "description": "Launch promotion: $50 free credits",
  "newBalance": "55000000"
}
Error responses:
HTTPCodeReason
404ACN-COUPON-001Code not found or invalid
409ACN-COUPON-002Already redeemed on this account
410ACN-COUPON-003Coupon has expired

Things to Know

  • Each coupon code can only be redeemed once per account
  • Credits from coupons never expire
  • Some coupons may have usage restrictions (e.g., first-time top-up required) — check the terms in your coupon email

Volume Discounts

When you top up above certain thresholds via Stripe, you automatically receive bonus credits on that purchase — no coupon code needed.
Top-Up AmountBonus
100100 – 499+5% bonus credits
500500 – 1,999+10% bonus credits
$2,000++15% bonus credits
Example: Top up $500 → receive 550,000,000 credits instead of 500,000,000 (10% bonus). Bonuses are applied at checkout time. The creditsToReceive field in the checkout API response reflects the final amount including any bonus:
curl -X POST https://api.acn.exchange/v1/billing/checkout \
  -d '{"amountUsdCents": 50000}'  # $500
{
  "checkoutUrl": "https://checkout.stripe.com/...",
  "creditsToReceive": "550000000"
}
Volume discounts are visible in the dashboard top-up card as you enter an amount.
Volume discounts apply to Stripe top-ups only, not on-chain USDC deposits. Tiers are subject to change.

Viewing Promotional Credits

Coupon credits and volume discount bonuses appear in your transaction history with type coupon_credit or volume_discount:
curl "https://api.acn.exchange/v1/billing/transactions?type=coupon_credit" \
  -H "Authorization: Bearer acn_sk_your_key"
{
  "transactions": [
    {
      "id": "txn_abc123",
      "type": "coupon_credit",
      "amountCredits": "50000000",
      "amountUsdc": "50.000000",
      "description": "Coupon: LAUNCH50 — Launch promotion: $50 free credits",
      "createdAt": "2026-03-19T10:00:00Z"
    }
  ]
}