🛡️ Check Fraud Protection API

Stop check fraud in 3 easy steps. Our API is so simple, anyone can use it!

⚡ How It Works (3 Steps)

Step 1️⃣ Get Your Free API Key

curl -X POST https://iconustech.com/api/request-api-key \
-H "Content-Type: application/json" \
-d '{"email": "you@company.com", "companyName": "Your Company"}'

✅ You'll get back: Your API key (save it!)

Step 2️⃣ Register a Check

When you write a check, tell us about it:

curl -X POST https://iconustech.com/api/v1/checks/register \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
  "checkNumber": "1001",
  "amount": 1500.00,
  "payeeName": "John Smith"
}'

✅ You'll get back: A QR code token to print on the check

Step 3️⃣ Verify a Check

When someone receives a check, verify it's real:

curl -X POST https://iconustech.com/api/v1/checks/verify \
-H "Content-Type: application/json" \
-d '{"qrToken": "qr_abc123def456"}'

✅ You'll get back: Is it safe? ✅ or 🚨

🎯 That's It! You're Protected!

💡 Why IconusTech?

| Feature | What It Means | |---------|---------------| | 🔐 Hash Security | We create a unique fingerprint for each check | | 📱 QR Codes | Scan to verify - it's that simple | | 🤖 AI Detection | Our AI catches fraud patterns automatically | | ⚡ Super Fast | Responses in under 200ms |

💰 Pricing

| Plan | Checks/Month | Cost | |------|--------------|------| | Free | 100 | $0 | | Pro | 5,000 | $29/mo | | Enterprise | Unlimited | Contact us |

📖 Complete API Reference

Base URL

https://iconustech.com/api

Check API is Working

curl https://iconustech.com/api/v1/health

{
"status": "healthy",
"version": "1.0.0"
}

📝 Register a Check

Tell us about a check you're writing.

| Field | Required | Example | |-------|----------|---------| | checkNumber | ✅ Yes | "1001" | | amount | ✅ Yes | 1500.00 | | payeeName | ✅ Yes | "John Smith" | | dateIssued | No | "2025-12-02" | | memo | No | "Invoice #123" |

curl -X POST https://iconustech.com/api/v1/checks/register \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"checkNumber": "1001", "amount": 1500.00, "payeeName": "John Smith"}'

What you get back:

{
"success": true,
"data": {
  "checkId": "check_abc123...",
  "qrToken": "qr_xyz789...",    // 👈 Print this on your check!
  "fraudScore": 0,
  "riskLevel": "LOW"
}
}

✅ Verify a Check

Check if a received check is real.

curl -X POST https://iconustech.com/api/v1/checks/verify \
-H "Content-Type: application/json" \
-d '{"qrToken": "qr_xyz789..."}'

Safe check:

{
"success": true,
"fraudDetected": false,
"riskLevel": "LOW",
"status": "ACTIVE"
}

Fraud detected:

{
"success": false,
"fraudDetected": true,
"riskLevel": "HIGH",
"reasons": ["Check has been voided"]
}

🤖 Risk Levels Explained

| Score | Level | What to Do | |-------|-------|------------| | 0-20 | ✅ LOW | Safe to accept | | 21-60 | ⚠️ MEDIUM | Review manually | | 61-85 | 🚨 HIGH | Probably reject | | 86-100 | ❌ CRITICAL | Don't accept! |

⚠️ Common Errors

| Error | Meaning | Fix | |-------|---------|-----| | 401 | Bad API key | Check your X-API-Key header | | 400 | Missing data | Include checkNumber, amount, payeeName | | 429 | Too many requests | Wait or upgrade your plan |

🔗 Connect QuickBooks

Auto-sync checks from your accounting software!

1. Go to /connect/quickbooks
2. Log in to QuickBooks
3. Click "Allow"
4. Done! ✅

📞 Need Help?

• 📧 Email: support@iconustech.com
• 🚀 Get Started: Sign up free
• 📊 Dashboard: Manage your keys