W2 DocsID Check IT Bravo
Compatible Cases
About the service
IDCheckITBravo is an identity verification service for Italy. It draws data from a proprietary database, historical fraud archive and telephone and address directory.
Product Code: W2-DATA-EKYC-IT-012
Does this service leave a credit search Footprint? Yes
Request
The following properties pertain to this service.
| Property Name | Type | Length | Optional/Mandatory | Notes |
|---|---|---|---|---|
| Forename | String | 30 | Mandatory | Can contain multiple forenames (separated by a space) if appropriate |
| MiddleNames | String | 15 | Optional | |
| Surname | String | 30 | Mandatory | |
| DayOfBirth | Integer | 2 | See notes | Day, month and year birth components must all have a value, or all be null. |
| MonthOfBirth | Integer | 2 | See notes | Day, month and year birth components must all have a value, or all be null. |
| YearOfBirth | Integer | 4 | See notes | Day, month and year birth components must all have a value, or all be null. |
| HouseName | String | 26 | Mandatory if no HouseNumber given | |
| HouseNumber | String | 26 | Mandatory if no HouseName given | |
| Street | String | 40 | Mandatory | |
| County | String | 2 | Mandatory | Province. This must be provided as the two character ISO code. e.g. "BG" for Bergamo. See provinces of Italy (Wikipedia). |
| Region | String | 2 | Optional | If included, this must be provided as the two digit ISO code. e.g. "62" for Lazio. See regions of Italy (Wikipedia). |
| City | String | 20 | Mandatory | |
| Postcode | String | 8 | Mandatory | This must be five numeric digits. e.g. "00040" |
| TaxCode | String | See notes | Codice Fiscale | |
| PlaceOfBirth | String | See notes | Municipality of birth | |
| PhoneNumber | String | Optional | Must be preceded by the area code in brackets: e.g. (0123) 565 555 44 | |
| MobileNumber | String | Optional | ||
| Gender | String | Mandatory | Must be 'M' or 'F' |
After performing the search, the validation result (pass, fail, etc.) will be part of the TransactionInformation returned for the service call.
Notes
It is mandatory that one of the following is provided:
TaxCode (codice fiscale) DayOfBirth, MonthOfBirth, YearOfBirth and PlaceOfBirth
Response
Example Response
"idCheckITBravoResult": {
"addressMatchResultType": "MATCH",
"referenceNumber": "4086000153992802"
}The following table gives some more details about the response.
| Property Name | Type | Description |
|---|---|---|
| AddressMatchResultType | String | Result on whether an address match has been found. |
| ReferenceNumber | String | A reference number for the check. |
Notes
AddressMatchType
Represents the type of match.
| Value | Description |
|---|---|
| MATCH | A Match can be found. |
| NO_MATCH | A Match has not been found. |
Sandbox
Example sandbox request
To use sandbox the following example request can be used.
Remember to include the W2 provided API key in the Authorization Header.
{
"Bundle": "KYC_IT_012",
"Data": {
"Forename": "Michael",
"Surname": "Tschank",
"HouseNumber": "51",
"Street": "Nobilegasse",
"City":"Wien",
"Postcode": "1150"
},
"Options": {
"Sandbox": "true"
},
"ClientReference": "your-client-reference"
}If the following details are set, a single fictitious match is returned in IDCheckITBravoResult:
| Property | Value |
|---|---|
| City: | "ROMA" |
| County: | "BM" |
| Forename: | "FILIPPO" |
| Gender: | "M" |
| HouseNumber: | "90" |
| Postcode: | "00133" |
| Street: | "DOMENICO BECCAFUMI" |
| Surname: | "BANGRAZI" |
| TaxCode: | "BNGFPP40T05C390C" |
The corresponding entry in ServiceTransactions will show the following properties:
| Property | Value |
|---|---|
| HaltTriggered: | False |
| ServiceTransactionResult: | Success |
| ServiceInterpretResult: | Pass |
| ServiceTransactionResultMessage: | "This call was generated using sandbox mode" |
| ValidationResult: | Pass |
Otherwise a fictitious no-match is returned.
The corresponding entry in ServiceTransactions will show the following properties:
| Property | Value |
|---|---|
| HaltTriggered: | False |
| ServiceTransactionResult: | Success |
| ServiceInterpretResult: | Inconclusive |
| ServiceTransactionResultMessage: | "This call was generated using sandbox mode" |
| ValidationResult: | Pass |