Critical Notes
- Just because the customer doesn’t have matching data at the credit bureau, doesn’t mean the overall KYC check has failed. It’s just the one possible matching source and is often just an out-of-date address.
- This also does NOT mean the customer has failed a credit check of any kind. Checking to see if personal details match those on file at the bureau has zero impact on a customer’s credit history or creditworthiness.
How to determine if you have to let the customer know?
There are 2 ways information is passed that a mismatch may have occurred. These will be found in the response from a CreateCheckEntity or UpdateCheckEntity API response (or also in the result of aGET /entity/checks response).
In the entityProfileResult clause
Note
The following section will only apply if using entity profiles/recipes.entityProfileResult clause of a response, there’s a section called creditHeaderFailures
Credit Header Failure
- Equifax
- Experian
- others upon request
In the checkSummary clause
Note
This following section will apply in all casescheckSummary clause’s CheckResults Key Value Pair Array:
| KvpKey | KvpType | KvpValues | Notes |
|---|---|---|---|
| Important.CreditBureauMatch. | Boolean | True / False | Indicates a match/fail with a credit header source that may require notification be sent to the customer. If set to true, the match was successful. If set to false, the match failed and the customer may need to be notified of this fact. The would be replaced with the reporting bureau. Valid values are: Equifax, Experian. There are other bureaus available as well. It’s possible for there to be more than one of these, depending on how your failover/cascade works. |