Skip to content
On this page

ID Check IT Bravo

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 NameTypeLengthOptional/MandatoryNotes
ForenameString30MandatoryCan contain multiple forenames (separated by a space) if appropriate
MiddleNamesString15Optional
SurnameString30Mandatory
DayOfBirthInteger2See notesDay, month and year birth components must all have a value, or all be null.
MonthOfBirthInteger2See notesDay, month and year birth components must all have a value, or all be null.
YearOfBirthInteger4See notesDay, month and year birth components must all have a value, or all be null.
HouseNameString26Mandatory if no HouseNumber given
HouseNumberString26Mandatory if no HouseName given
StreetString40Mandatory
CountyString2MandatoryProvince. This must be provided as the two character ISO code. e.g. "BG" for Bergamo. See provinces of Italy (Wikipedia).
RegionString2OptionalIf included, this must be provided as the two digit ISO code. e.g. "62" for Lazio. See regions of Italy (Wikipedia).
CityString20Mandatory
PostcodeString8MandatoryThis must be five numeric digits. e.g. "00040"
TaxCodeStringSee notesCodice Fiscale
PlaceOfBirthStringSee notesMunicipality of birth
**PhoneNumber**StringOptional
MobileNumberStringOptional
GenderStringMandatoryMust 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

json
"idCheckITBravoResult": {
	"addressMatchResultType": "MATCH",
	"referenceNumber": "4086000153992802"
}

The following table gives some more details about the response.

Property NameTypeDescription
AddressMatchResultTypeStringResult on whether an address match has been found.
ReferenceNumberStringA reference number for the check.

Notes

AddressMatchType
Represents the type of match.

ValueDescription
MATCHA Match can be found.
NO_MATCHA 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.

json
{
    "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:

PropertyValue
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:

PropertyValue
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:

PropertyValue
HaltTriggered:False
ServiceTransactionResult:Success
ServiceInterpretResult:Inconclusive
ServiceTransactionResultMessage:"This call was generated using sandbox mode"
ValidationResult:Pass