Enhanced Due Diligence

Initiate an Enhanced Due Diligence (EDD) case for a verified customer to increase their activity limits.

Create an EDD case

Initiate an Enhanced Due Diligence (EDD) case for a verified individual or business customer who needs higher activity limits:

POST /api/identity_verifications

{
  "type": "kyc",
  "method": "enhanced_due_diligence",
  "customer_guid": "customer_guid"
}

{
  "created_at": "datetime",
  "updated_at": "datetime",
  "type": "kyc",
  "guid": "identity_verification_guid",
  "method": "enhanced_due_diligence",
  "customer_guid": "customer_guid",
  "state": "storing",
  "outcome": null,
  "failure_codes": [],
  "compliance_decisions": []
}

Retrieve the Persona inquiry ID

Retrieve the persona_inquiry_id to pass to the Persona SDK:

GET /api/identity_verifications/{identity_verification_guid}

{
  "created_at": "datetime",
  "updated_at": "datetime",
  "type": "kyc",
  "guid": "identity_verification_guid",
  "method": "enhanced_due_diligence",
  "customer_guid": "customer_guid",
  "state": "waiting",
  "outcome": null,
  "failure_codes": [],
  "persona_inquiry_id": "inq_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "persona_state": "waiting",
  "compliance_checks": [],
  "compliance_decisions": []
}

API errors

❗️
Customer must be verified
The customer must be in the verified state. Otherwise the API returns a 422 error:

{
  "status": 422,
  "error_message": "Customer has not been verified",
  "message_code": "unverified_customer"
}

❗️
Duplicate case error
If the customer already has an EDD case in the waiting state, the API returns a 409 error:

{
  "status": 409,
  "error_message": "Identity verification in progress already exists",
  "message_code": "data_exists"
}

For more details on identity verifications and state descriptions, see the API reference.

Updated 12 days ago