Docs

1Utilisation de base de la validation d’adresse

Dans son utilisation la plus simple, la validation d’adresse peut valider une adresse depuis n’importe quel site web. Pour ce faire, un JavaScript doit être intégré, puis la fonction JavaScript correspondante peut être utilisée pour valider l’adresse.

Voici un exemple simple :

<script type="text/javascript" src="https://sandbox.app-wallee.com/assets/js/i18n/address-handler.js"></script>

<script type="text/javascript">
var address = {
	"givenName": "Marc",
	"familyName": "Stiffer",
	"street": "Some Street Name including street number etc.",
	"postcode": "The post code of the address. e.g. 8000",
	"country": "US",
	"postalState": "CA",
	"city": "Some City Name"
};

AddressHandler.validateAddress(address).then(function(){
	// You may want to continue processing here.
	console.log("The address is valid.");
}, function(invalidFields){
	console.log(invalidFields);

	for(var i = 0; i < invalidFields.length; i++){
		var fieldName = invalidFields[i].field;
		var errorMessage = invalidFields[i].message;
		// Here you may want to implement the user feedback about the invalid address field.
		console.log("The field " + fieldName + " is invalid. Error: " + errorMessage);
	}
});
</script>

L’exemple ci-dessus valide l'`address` fournie. Les messages d’erreur fournis dans la réponse dépendront de la langue du navigateur. La langue peut également être imposée en fournissant un paramètre language sur l'`address-handler.js`. Par exemple, si l’allemand doit être imposé, l’URL suivante peut être utilisée :

<script type="text/javascript" src="https://sandbox.app-wallee.com/assets/js/i18n/address-handler.js?language=de"></script>

2Listes des pays, des états et des formes juridiques d’organisation

En règle générale, une adresse peut être construite dans le navigateur. Cependant, il peut être nécessaire d’afficher une liste des pays, des états et des formes d’organisation disponibles. L’exemple ci-dessous montre comment utiliser la validation d’adresse pour récupérer ces éléments de données :

<script type="text/javascript" src="https://sandbox.app-wallee.com/assets/js/i18n/address-handler.js"></script>

<script type="text/javascript">
AddressHandler.getCountries().then(function(countries) {
	console.log(countries);
});

AddressHandler.getCountryStates("CH").then(function(states) {
	console.log(states);
});

AddressHandler.getLegalOrganizationForms("CH").then(function(legalForms) {
	console.log(legalForms);
});

</script>