Testing in the Sandbox Environment
Sandbox Testing
Testing AeroPass in the Sandbox with AeroStub (Bypass OTP)
Testing the AeroPass network flow in Sandbox normally requires a real one-time passcode (OTP). AeroStub lets you skip that by accepting a set of static OTP codes, so you can run the full flow without a real phone or code.
AeroStub applies to the AeroPass network flow only. You must launch the widget with an
aeroPassUserUuid.
Before you start
| You need | What it is |
|---|---|
| AeroStub enabled | One-time setup by the Aerosync team. See Prerequisite — Ask Aerosync to enable AeroStub. |
configurationId | The unique ID assigned to you that applies your widget customizations. |
aeroPassUserUuid | Identifies the AeroPass user. This is required for the AeroPass network flow. |
Prerequisite — Ask Aerosync to enable AeroStub
Raise a support request to the Aerosync team to enable AeroStub for your configurationId.
AeroStub is available in lower environments only and is never enabled in production, so it is safe to leave on for testing. You only need to request this setup once.
Running the flow
- Launch the AeroSync widget in Sandbox with your
configurationIdandaeroPassUserUuid. - Click Continue.
- On the passcode screen, enter one of the static OTP codes below:
- Enter
0000to test the happy path. - Enter an error code to test a failure state.
- Enter
Static OTP codes
| Code | Result |
|---|---|
0000 | ✅ Success — authentication passes, and the flow continues. |
0001 | ❌ Code expired. Returns OTP_EXPIRED. |
0002 | ❌ Too many attempts. Returns TOO_MANY_ATTEMPTS. |
0003 | ❌ Account not found. Returns ACCOUNT_NOT_FOUND. |
0004 | ❌ Server error. Returns SERVER_ERROR. |
| Any other code | ❌ Invalid code. Returns INVALID_OTP. |
Updated 1 day ago
Did this page help you?