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
- Go to Billing in the left sidebar
- Click Redeem Coupon
- Enter your coupon code (case-insensitive)
- 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:
| HTTP | Code | Reason |
|---|
| 404 | ACN-COUPON-001 | Code not found or invalid |
| 409 | ACN-COUPON-002 | Already redeemed on this account |
| 410 | ACN-COUPON-003 | Coupon 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 Amount | Bonus |
|---|
| 100–499 | +5% bonus credits |
| 500–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.
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"
}
]
}