Test mode · Never charged

Test mode: build and test for free

Test mode is included with the Growth plan ($299/month). Use test keys to run your whole integration, from creating checks to webhooks and PDF reports, without a real ID. Test checks are free of charge.

Test keys

Test mode is included with the Growth plan (test checks are free of charge). Create test keys in API Keys. The key decides the mode, so the same code runs in test or live by swapping the key.

KeyWhereMode
ais_test_Your server (secret)Test
ais_pk_test_Your website (publishable)Test
ais_live_Your server (secret)Live
ais_pk_live_Your website (publishable)Live
  • Test checks have livemode: false and are stored separately. A test key only sees test checks, and a live key only sees live checks.
  • In the dashboard, the Live / Test switch on Verifications shows each set. Test checks are left out of your usage figures.
  • Test checks don't need credit, so you can build before topping up.

Test scenarios

A test check's customer link (and the SDK frame) opens a clearly marked TEST page instead of the camera. No ID document or selfie is taken. Each scenario below is one choice on that page, or one call or button, and none of them is charged:

ScenarioHow to run itStatus and resultWebhook
PassChoose Approve on the TEST page. ID, selfie, liveness and AML all pass.completed, result approvedverification.completed
DeclineChoose Decline. The face match fails, so the check is declined.completed, result declinedverification.failed
Needs reviewChoose Needs review. Open the link again later to approve or decline it.in_review, then the final resultverification.review, then the final event
Customer abandonsChoose Abandon. The customer leaves without finishing.abandonedverification.expired
Cancel an open checkCall POST /api/v1/verifications/{id}/cancel on a test check that hasn't finished.canceledverification.canceled
Sample webhook onlyOn the Webhooks page in the dashboard, press Send test event and pick an event type. Works before you create any check.A signed sample, verification id ver_test_sampleThe event type you pick, sent once with no retries

Creating the check sends verification.created, and choosing an outcome first sends verification.started (once per check). How expired links and webhook retries work is on the Webhooks page.

What behaves exactly like live

The outcome you choose runs through the same completion code as a real check, so your integration sees the real thing:

  • Statuses and results in the API, in the same verification object.
  • Webhooks, signed the same way, sent to your test endpoints only.
  • Result emails to your team (marked TEST).
  • The PDF report from GET /api/v1/verifications/{id}/report.pdf, built from simulated data and watermarked TEST.
  • The SDK, its callbacks and Allowed domains.

Simulated results

Test checks return realistic, clearly fake data (a sample Australian driver licence for "Test Customer", or the customer name you passed):

CheckApproveDeclineNeeds review
documentpassedfailedpassed
face_matchpassed, score 96.8failed, score 31.2review, score 68.5
livenesspassedpassedpassed
amlpassed, 0 hitspassed, 0 hitsreview, 1 hit

Try it

Create a test check (example values)
curl https://portal.australianidentitysolutions.com.au/api/v1/verifications \
  -H "Authorization: Bearer $AIS_TEST_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reference": "test_001", "send_email": false }'

Open the verification_url it returns, pick an outcome and watch your test webhook endpoint. Or embed it with a test publishable key:

SDK in test mode
AIS.mount({
  publishableKey: "ais_pk_test_YOUR_TEST_PUBLISHABLE_KEY",  // example test key: never charged
  container: "#ais-verify"
});
In the Webhooks page, Send test event sends a signed sample of any event type to one endpoint at no cost, even before you create a check.

What is and isn't charged

Charged?
Any test-mode check, whatever the outcomeNever
Send test event from the dashboardNever
Live check completed, approvedYes, once
Live check completed, declinedYes, once (the full check was carried out)
Live check in reviewNot until it ends approved or declined
Live check abandoned, expired or cancelledNever

API, SDK, widget, webhooks and test mode are included with the Growth plan only ($299/month, 75 checks included, then $3.99 a check). Pay As You Go and Business accounts use the dashboard and do not include API access. Live prices are on the pricing page: the Growth plan is $299 a month with 75 checks included and $3.99 a check after that.