Italy (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

Property	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 below	Day, month, and year birth components must all have a value, or all be null.
MonthOfBirth	Integer	2	See notes below	Day, month, and year birth components must all have a value, or all be null.
YearOfBirth	Integer	4	See notes below	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
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
City	String	20	Mandatory
Postcode	String	8	Mandatory	This must be five numeric digits. e.g., "00040"
TaxCode	String		See notes below	Codice Fiscale
PlaceOfBirth	String		See notes below	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
PlaceOfBirth

Response

Example response

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

The response breakdown is as follows:

Property	Type	Description
AddressMatchResultType	String	Result on whether an address match has been found. Value can be: - MATCH : A match can be found - NO_MATCH : A match has not been found
ReferenceNumber	String	A reference number for the check.

Sandbox

To use sandbox the following example request can be used.

Remember to include the W2 provided API key in the Authorization Header.

Example sandbox request

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