Using mock passports

# Using mock passports Mock passports are how you exercise verification end-to-end without a real passport. Useful for development, CI, and demos. Mock passports only work against flows in your **test** environment (i.e. sessions created with an `sk_test_` key). They never verify against live flows. See [Test vs. live](/docs/self-enterprise/flows/test-vs-live/). ## Generating a mock passport 1. On the Self app's home screen, tap the **settings gear** in the top-right corner. <figure><img loading="lazy" src="/docs/docs-assets/mobile-home-screen-1.avif" alt="Self app home screen with the settings gear in the top-right corner" width="188"><figcaption></figcaption></figure> 2. In Settings, tap **Manage ID documents**. <figure><img loading="lazy" src="/docs/docs-assets/mobile-settings-2.avif" alt="Self app settings with the Manage ID documents option" width="188"><figcaption></figcaption></figure> 3. Tap **Generate Mock Document**. The Mock Document screen opens with a preview of the dev passport. <figure><img loading="lazy" src="/docs/docs-assets/mobile-mock-document-3.avif" alt="Mock Document screen with the generate mock document data card and a dev passport preview" width="188"><figcaption></figcaption></figure> 4. Under **Mock Document Parameters**, set the attributes you want to test against (nationality, age, document expiry, OFAC status), then tap **Generate Mock Document**. <figure><img loading="lazy" src="/docs/docs-assets/mobile-generate-mock-4.avif" alt="Mock document parameters: nationality, age, document expiry, and OFAC status, with the Generate Mock Document button" width="188"><figcaption></figcaption></figure> The generated document appears as a card on the home screen, ready to use. To try the whole loop end-to-end without writing any code, deploy a configuration and use the **Try this flow** link on its Configure tab; test sessions accept mock passports. To stop using a mock passport, select a different document from the home screen. Real documents are added from the same **Manage ID documents** screen via **Add New Document**.

Mock passports are how you exercise verification end-to-end without a real passport. Useful for development, CI, and demos.

Mock passports only work against flows in your test environment (i.e. sessions created with an sk_test_ key). They never verify against live flows. See Test vs. live.

Generating a mock passport

On the Self app’s home screen, tap the settings gear in the top-right corner.
In Settings, tap Manage ID documents.
Tap Generate Mock Document. The Mock Document screen opens with a preview of the dev passport.
Under Mock Document Parameters, set the attributes you want to test against (nationality, age, document expiry, OFAC status), then tap Generate Mock Document.

The generated document appears as a card on the home screen, ready to use.

To try the whole loop end-to-end without writing any code, deploy a configuration and use the Try this flow link on its Configure tab; test sessions accept mock passports.

To stop using a mock passport, select a different document from the home screen. Real documents are added from the same Manage ID documents screen via Add New Document.

Was this page helpful?