Overview

In general, running a KYB in the sandbox results in an initialized status and a corresponding kyb.verification.initiated webhook event. However, for testing purposes you might want to trigger the KYB status to be in the rejected or warning state.

You can use the ein and legal_business_name properties of a Business resource to trigger the KYB status.

Triggering KYB scenarios

The following table lists the event and trigger used to set the KYB status.

Mock event	Business resource/ein
`kyb.verification.warning`	{ `"ein"`: `"11-0000099"` }
`kyb.verification.rejected`	{ `"ein"`: `"11-0000099"`, `"legal_business_name"`: `"Unregistered Business"` }
`kyb.verification.approved`	Any

The following is an example of a successful request to change the KYB status.

{
    "business_id": "86da242e-f83a-466c-93a5-211755aa6b6b",
    "kyb_status": "rejected",
    "details": [
        {
            "code": "rejected_address",
            "reason": "address verification failed"
        },
        {
            "code": "rejected_name",
            "reason": "name verification failed"
        }
    ]
}

For a complete specification and interactive examples, see Simulate KYB scenarios.