Integration Testing

Testing integrations using Sandbox Inquiries

Integration Testing

Testing integrations using Sandbox Inquiries

It may be valuable to programmatically test your various API integrations with the Persona platform. For example, throughout the Inquiry Model Lifecycle, the Inquiry may change status and fire associated Events as your customer progresses through the Inquiry. Similarly, within the Inquiry lifecycle, Verifications may be created and processed through the Verification Lifecycle, also changing status and firing associated events.

You can setup webhooks to notify your service about these events. You may also choose to directly fetch an Inquiry or fetch a Verification at anytime during their respective lifecycles. Your application may be set up to take certain actions based on these Events or on the data contained within the Inquiry or Verification.

After creating a Sandbox Inquiry, the following Simulate Actions can be specified to evoke Inquiry and Verification lifecycle behavior, thereby replicating the necessary conditions required for programmatically testing the behavior of your application.

The relevant endpoint is the Inquiries Perform Simulate Actions endpoint.

Simulate Actions

Inquiry Status

The following actions evoke behavior around the Inquiry lifecycle:

Simulate Action	Effects
`start_inquiry`	Set Inquiry status to `pending` Fire `inquiry.started` event
`complete_inquiry`	Set Inquiry status to `completed` Fire `inquiry.completed` event
`fail_inquiry`	Set Inquiry status to `failed` Fire `inquiry.failed` event
`expire_inquiry`	Set Inquiry status to `expired` Fire `inquiry.expired` event
`mark_for_review_inquiry`	Set Inquiry status to `needs_review` Fire `inquiry.marked-for-review` event
`approve_inquiry`	Set Inquiry status to `approved` Fire `inquiry.approved` event
`decline_inquiry`	Set Inquiry status to `declined` Fire `inquiry.declined` event

Creating Verification with Status

The following actions evoke behavior around creating and processing a verification:

Simulate Action	Effects
`create_passed_verification`	Create a Verification with status `passed` Fire the following events in order: Events specific to the Verification type `verification.created` `verification.submitted` `verification.passed`
`create_failed_verification`	Create a Verification with status `failed` Fire the following events in order: Events specific to the Verification type `verification.created` `verification.submitted` `verification.failed`

Supported Verification types

The following are the Verification types currently supported, and their associated type-specific events:

Verification Type	Type-specific Events
Government ID	`document.created` `document.submitted` `document.processed`
Document	`document.created` `document.submitted` `document.processed`
Database	None
Selfie	`selfie.created` `selfie.submitted` `selfie.processed`