Italy
 
SOAP API > Validating Payments > Bank Account Numbers > validateAccount > Countries >
validateAccount: Italy    

Validate Account Number: Italy

Country Name: Italy
ISO Code: IT

Syntax:

validateAccount(string keycode, string field1,string field2,string field3,string field4,string countryId,string countrySpec)


1) Check digit , Bank code, Branch code & Account number  as separate variables:

 

 Field  Explanation  Format Example 
 keycode  Your Validate keycode    
 field1  Check digit  1a  X
 field2  Bank code  5n  12345
 field3  Branch code  5n  12345
 field4  Account number  12an  123456789012
 countryId  The ISO Country Code  2a  IT

 

 

 

2) When you have Check digit , Bank code, Branch code & Account number as one variable the  23 digit Italy electronic transmission format or Traditional representation can be used:

 

 Field  Explanation  Format Example 
 keycode  Your Validate keycode    
 field1  Account Structure  23an

 i)  X 05428 11101 000000123456
 ii) X0542811101000000123456
 iii) X-05428-11101-000000123456
 etc

 field2  Not Used  
 field3  Not Used    
 field4  Not Used    
 countryId  The ISO Country Code  2a IT

 

Note

countrySpec is not used for this country, use an empty string "".

 

Returned data

An object containing the following:

 Name  Description
 field1  field 1 from the original request
 field2  field 2 from the original request
 field3  field 3 from the original request
 field4  field 4 from the original request
 validity  String ‘Valid’ if the IBAN is valid.

 String ‘Invalid’ if the IBAN is not valid. 

 A Valid BIC is defined as a BIC that resolved to a real Bank branch office.

 bic  The full Bank Identification Code (BIC) of the account holding branch - if available
 branchTitle  The account holding branch title as defined by the bank
 institutionName  The parent financial institution of the account holding branch
 city  The city that the account holding branch is located
 address1  Address line 1 of the account holding branch
 address2  Address line 2 of the account holding branch
 address3  Address line 3 of the account holding branch
 address4  Address line 4 of the account holding branch
 postcode  The postcode/zipcode of the account holding branch
 country  The country that the account holding branch is located
 tel1  Telephone number 1 of the account holding branch
 tel2  Telephone number 2 of the account holding branch - often but not always the fax number
 errorCode  If an error occurs during processing the error number will be here.  See the error section for more details.
 errorText  If an error occurs during processing the error textually description will be here.  See the error section for more details.


 


 

 ©Copyright 2023 Paygate Solutions Limited