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.
| Key | Where | Mode |
|---|---|---|
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: falseand 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:
| Scenario | How to run it | Status and result | Webhook |
|---|---|---|---|
| Pass | Choose Approve on the TEST page. ID, selfie, liveness and AML all pass. | completed, result approved | verification.completed |
| Decline | Choose Decline. The face match fails, so the check is declined. | completed, result declined | verification.failed |
| Needs review | Choose Needs review. Open the link again later to approve or decline it. | in_review, then the final result | verification.review, then the final event |
| Customer abandons | Choose Abandon. The customer leaves without finishing. | abandoned | verification.expired |
| Cancel an open check | Call POST /api/v1/verifications/{id}/cancel on a test check that hasn't finished. | canceled | verification.canceled |
| Sample webhook only | On 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_sample | The 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):
| Check | Approve | Decline | Needs review |
|---|---|---|---|
document | passed | failed | passed |
face_match | passed, score 96.8 | failed, score 31.2 | review, score 68.5 |
liveness | passed | passed | passed |
aml | passed, 0 hits | passed, 0 hits | review, 1 hit |
Try it
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:
AIS.mount({
publishableKey: "ais_pk_test_YOUR_TEST_PUBLISHABLE_KEY", // example test key: never charged
container: "#ais-verify"
});What is and isn't charged
| Charged? | |
|---|---|
| Any test-mode check, whatever the outcome | Never |
| Send test event from the dashboard | Never |
| Live check completed, approved | Yes, once |
| Live check completed, declined | Yes, once (the full check was carried out) |
| Live check in review | Not until it ends approved or declined |
| Live check abandoned, expired or cancelled | Never |
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.