Advanced KYC System Failure Triggers
These triggers are not applicable on Priority.
We are actively working with Priority on allowing broader testing.
Sandbox and Advanced KYC Only
You can use these values to trigger a KYC/KYB failure status in the Sandbox environment only.
If you are using Classic KYC, please use the triggers detailed here.
Failure Trigger Values
Use the values provided below in /register to trigger different KYC failure statuses. Please note that triggers are not necessarily the same across KYC and KYB.
One trigger per /register call
Use only one of the below triggers per /register call. If you use multiple, only one trigger will be applied.
| Attribute | Value | Failure Reason |
|---|---|---|
| Zip code | 88888 | address not matched |
| Zip code | 99999 | address warning |
| SSN | 777777777 | ssn miskey |
| SSN | 888888888 | ssn not matched |
| SSN | 999999999 | ssn warning |
| FEIN (KYB) | 000000000 | business company name not matched |
| FEIN (KYB) | 111111111 | secretary of state warning |
| FEIN (KYB) | 222222222 | watchlist warning |
| FEIN (KYB) | 999999999 | fein not matched |
| Last name | ofac | ofac sanctions match |
| Last name | birthdate | birthdate not matched |
| Last name | fraud | fraud warning |
| Last name | EmailRisk | email risk |
| Last name | PhoneRisk | phone risk |
| Last name | pass | Assuming a unique SSN and email are provided, will ensure a passing verification |
Passing After Triggering a Failure
After using one of the above failure triggers, use /resume_verification to clear it and get a passed verification status.
Updated about 1 month ago