Simulate KYC outcomes

By default, all KYC applications in the sandbox are automatically approved. Use the inputs below to simulate specific outcomes during testing.

Outcome	How to trigger
Approved (default)	Submit any application normally — no special input required
Document verification declined	Set the customer’s first name to `Decline` (case-sensitive)
EDD Required	Set occupation type to `Other` with the value `EDD Required`

When EDD Required is triggered, the application pauses and must be manually resolved by a Meridian ops user before onboarding can continue. See Handling onboarding exceptions for details on how to handle this status in your integration.

Resetting a test user

In sandbox, you can delete a user’s virtual account application to reset their onboarding state. This lets you run the same user through onboarding repeatedly in automated test scripts without needing to create a new user each time. Use the Delete a virtual account application endpoint to delete the application, then submit a new one to go through onboarding again from the beginning.

This endpoint is only available in sandbox. Virtual account applications cannot be deleted in production.

Information we collect Deposits

⌘I

​Resetting a test user

Resetting a test user