Simulating KYC Failures

To simulate a KYC failure scenario in sandbox, you may call the enroll endpoint with the following request body:

{
  "first_name": "kyc",
  "last_name": "simulator",
  "dob": "2021-01-01",
  "phone_number": "1234567890",
  "ssn": "000-00-0001",
  "street1": ..., // any valid input
  "zipcode": ..., // any valid input
  "email": ..., // any valid input
  "kyc_type": ..., // any valid input
  "tos_timestamp": ... // any valid input
}

In order to simulate a KYC failure with a specific reason, below are the possible values for the ssn property:

"000-00-0001": "ADDRESS_VERIFICATION_FAILURE"
"000-00-0002": "NAME_VERIFICATION_FAILURE"
"000-00-0003": "DOB_VERIFICATION_FAILURE"
"000-00-0004": "SSN_VERIFICATION_FAILURE"
"000-00-0005": "OTHER_VERIFICATION_FAILURE"
"000-00-0006": "AGE_THRESHOLD_FAILURE"
"000-00-0007": "RISK_THRESHOLD_FAILURE"
"000-00-0008": "BLOCKLIST_ALERT_FAILURE"
"000-00-0009": "PHONE_VERIFICATION_FAILURE"
"000-00-0010": "UNEXPECTED_VERIFICATION_FAILURE"

Sample Request

curl https://api.lithic.com/v1/enroll/consumer \
  -X POST \
  -H "Authorization: api-key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"kyc","last_name":"simulator","dob":"2021-01-01","phone_number":"1234567890","street1":"123 Main Street","zipcode":"10128","email":"[email protected]","ssn":"000-00-0001"}'