Test Your AntifraudAI Integration Using the Sandbox

The AntifraudAI sandbox is a full-fidelity replica of the production environment that processes no real payments and incurs no charges. It uses the same ML models, rule engine, webhook infrastructure, and Cases API as production, but operates on fully isolated data. Test every branch of your integration — including block decisions, case creation, and webhook delivery — before you go live.

Sandbox vs. Production

	Sandbox	Production
Base URL	`https://sandbox.antifraudai.com/v1`	`https://api.antifraudai.com/v1`
API key prefix	`sk_test_`	`sk_live_`
Billing	Free	Metered
Data	Isolated; no real users or transactions	Live user data
Webhooks	Delivered to configured endpoints	Delivered to configured endpoints
Cases	Created and manageable via API/dashboard	Created and manageable via API/dashboard
Custom rules	Independently configured per environment	Independently configured per environment

Creating a Sandbox API Key

Open API Keys settings

In the AntifraudAI dashboard, navigate to Settings → API Keys.

Create a new key

Click Create Key. Give the key a descriptive name such as My App — Sandbox.

Choose the Sandbox environment

Under Environment, select Sandbox. The generated key will begin with sk_test_.

Copy and store the key

Copy the key immediately — it will not be shown again. Store it in your .env file or secrets manager under a variable such as ANTIFRAUDAI_API_KEY.

Test Trigger Values

The sandbox recognises special user_id values that produce deterministic, pre-configured outcomes. Use these to reliably test each branch of your decision-handling code without needing to craft specific payload combinations.

`user_id`	Resulting decision	Risk score	Signals
`test_allow`	`allow`	5	—
`test_review`	`review`	55	`["review_threshold_met"]`
`test_block`	`block`	92	`["high_risk_score"]`
`test_high_velocity`	`review`	61	`["high_velocity"]`
`test_vpn`	`block`	85	`["vpn_detected"]`

Example — triggering a block decision:

cURL

curl -X POST https://sandbox.antifraudai.com/v1/transactions/screen \
  -H "Authorization: Bearer sk_test_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "test_block",
    "amount": 199.00,
    "currency": "USD",
    "ip_address": "203.0.113.5",
    "payment_method": "card"
  }'

Response

{
  "transaction_id": "txn_sandbox_001",
  "risk_score": 92,
  "decision": "block",
  "signals": ["high_risk_score"],
  "created_at": "2024-03-15T11:00:00Z"
}

Trigger values only take effect in the sandbox environment. Sending test_block as a user_id in production is treated as a regular user and scored by the live ML model.

Testing Webhooks Locally

To receive sandbox webhook deliveries on your local development machine, expose a local port to the internet using a tunnel tool.

Install a tunnel tool

Choose a tool such as ngrok or Cloudflare Tunnel and install it on your machine:

# macOS via Homebrew
brew install ngrok
ngrok http 3000

# macOS via Homebrew
brew install cloudflared
cloudflared tunnel --url http://localhost:3000

Copy the public URL

The tool will print a public HTTPS URL (e.g. https://abc123.ngrok.io). Copy it.

In the AntifraudAI dashboard, ensure you are in the Sandbox environment. Go to Settings → Webhooks → Add Endpoint and paste your tunnel URL, appending your handler path (e.g. https://abc123.ngrok.io/webhooks/antifraudai).

Send a test transaction and observe the delivery

Submit a transaction using a trigger user_id such as test_review and watch your local server logs. A case.created event should arrive within seconds. You can also inspect the full request and response in the tunnel tool’s local dashboard (e.g. http://localhost:4040 for ngrok).

Tunnel URLs are temporary — they change each time you restart the tool. Update your sandbox webhook endpoint whenever you start a new tunnel session.

Run your complete end-to-end flow in sandbox before deploying to production: screen a transaction → receive the webhook → inspect the case in the dashboard → resolve it via the API → confirm the case.resolved webhook fires. This ensures every integration point is working correctly under realistic conditions.

Get Started

Core Concepts

Guides

Configuration

Help

Test Your AntifraudAI Integration Using the Sandbox

Sandbox vs. Production

Creating a Sandbox API Key

Test Trigger Values

Testing Webhooks Locally

​Sandbox vs. Production

​Creating a Sandbox API Key

​Test Trigger Values

​Testing Webhooks Locally

Sandbox vs. Production

Creating a Sandbox API Key

Test Trigger Values

Testing Webhooks Locally