Schemi per la protezione degli account

In questo articolo vengono descritti gli schemi tramite l'interfaccia API. Per ulteriori informazioni, vedere Integrare le API in tempo reale di Dynamics 365 Fraud Protection.

AccountCreation

L'API AccountCreation consente di condividere informazioni e contesto con Microsoft Dynamics 365 Fraud Protection sugli eventi in arrivo per la creazione di nuovi account per la valutazione dei rischi.

Oggetto	Attributo	Tipo	Descrizione
	ID tenant	stringa	TenantId è il GUID che rappresenta il tenant di Azure ActiveDirectory.
	Nome	stringa	Il valore è AP.AccountCreation.
	Versione	stringa	Il valore è 0,5.
MetaData	trackingId	stringa	Identificatore dell'evento AccountCreationId.
MetaData	SignupId	stringa	Identificatore dell'evento AccountCreationId. (questo valore può corrispondere al valore dell'attributo trackingId ma è diverso dall'attributo userid).
MetaData	assessmentType	stringa	Il tipo di valutazione per l'evento. I valori possibili sono evaluate e protect. Se non viene specificato alcun valore, il valore predefinito è protect.
MetaData	customerLocalDate	dateTime	La data di creazione dell'evento AccountCreationId nel fuso orario locale del cliente. Il formato è ISO 8601.
MetaData	merchantTimeStamp	dateTime	Timestamp dell'evento.
DeviceContext	DeviceContextId	stringa	ID sessione del cliente. Tali informazioni sono fornite dal servizio di creazione impronta digitale dispositivo di DFP.
DeviceContext	ipAddress	stringa	L'indirizzo IP del cliente, come fornito dal fornitore.
DeviceContext	provider	stringa	Il provider delle informazioni del dispositivo. I valori possibili sono 'DFPFingerprinting' e 'Merchant'. Se non viene specificato alcun valore, il valore predefinito è DFPFingerprinting.
DeviceContext	externalDeviceId	stringa	ID dispositivo del cliente, come fornito e gestito dal fornitore.
DeviceContext	externalDeviceType	stringa	Tipo di dispositivo del cliente, come fornito e gestito dal fornitore. I valori possibili sono Mobile, Computer, MerchantHardware, Tablet e GameConsole.
Utente	userId	stringa	Identificatore dell'utente. Tali informazioni sono fornite dal fornitore.
Utente	userType	stringa	Tipo di profilo dell'utente. Valori possibili: Consumer, Developer, Seller, Publisher e Tenant.
Utente	UserName	stringa	Il nome utente fornito dall'utente che è univoco nel sistema commerciale.
Utente	firstName	stringa	Nome fornito dall'utente nell'account.
Utente	lastName	stringa	Cognome fornito dall'utente nell'account.
Utente	CountryRegion	stringa	Paese o area geografica dell'utente. Il valore deve essere un codice paese/area geografica ISO di due lettere, ad esempio IT.
Utente	zipCode	stringa	Codice postale dell'utente.
Utente	timeZone	stringa	Il fuso orario dell'utente.
Utente	lingua	stringa	La lingua e l'area dell'utente, ad esempio EN-US.
Utente	membershipId	stringa	L'ID di appartenenza, se l'utente dispone già di appartenenza esistente con il fornitore.
Utente	isMembershipIdUserName	bool	Un valore Vero/Falso che indica se il valore membershipId può essere utilizzato come nome utente. Il valore predefinito è Falso.
Telefono	phoneType	enum	Tipo di numero di telefono. I valori possibili sono Primary e Alternative. Il valore predefinito è Primary.
Telefono	phoneNumber	stringa	Numero di telefono dell'utente. Il formato deve essere il prefisso del paese o dell'area geografica seguito da un trattino (-) e quindi numero di telefono, ad esempio per gli Stati Uniti, 1-1234567890.
Telefono	isTelefonoNumberValidated	bool	Valore Vero/Falso che indica se il numero di telefono fornito dall'utente è stato verificato come di proprietà dell'utente.
Telefono	phoneNumberValidatedDate	dateTime	La data di convalida del numero di telefono dell'utente. Il formato è ISO 8601.
Telefono	isTelefonoUserName	bool	Un valore Vero/Falso che indica se il numero di telefono può essere utilizzato come nome utente. Il valore predefinito è Falso.
Indirizzo di posta elettronica	emailType	enum	Tipo di indirizzo di posta elettronica. I valori possibili sono Primary e Alternative.
Messaggio e-mail	emailValue	stringa	Indirizzo e-mail dell'utente Questo valore non fa distinzione tra maiuscole e minuscole.
Indirizzo di posta elettronica	isE-mailValidated	bool	Valore Vero/Falso che indica se l'indirizzo e-mail fornito dall'utente è stato verificato come di proprietà dell'utente.
Indirizzo di posta elettronica	emailValidatedDate	dateTime	La data di convalida dell'indirizzo di posta elettronica dell'utente. Il formato è ISO 8601.
Indirizzo di posta elettronica	isE-mailUserName	bool	Un valore Vero/Falso che indica se l'indirizzo di posta elettronica può essere utilizzato come nome utente. Il valore predefinito è Falso.
SSOAuthenticationProvider	authenticationProvider	stringa	Il provider di autenticazione SSO (single sign-on) dell'utente, se diverso dal provider di autenticazione SSO del fornitore. I valori possibili sono MSA, Facebook, PSN, MerchantAuth e Google.
SSOAuthenticationProvider	displayName	stringa	Il nome visualizzato dell'utente per il provider di autenticazione SSO (ad esempio, il nome utente da un account Microsoft, Facebook o Google).
Indirizzo	addressType	enum	Tipo di indirizzo. I valori possibili sono Primary, Billing, Shipping e Alternative. Il valore predefinito è Primary.
Indirizzo	firstName	stringa	Nome fornito dall'utente che è associato all'indirizzo.
Indirizzo	lastName	stringa	Cognome fornito dall'utente che è associato all'indirizzo.
Indirizzo	phoneNumber	stringa	Numero di telefono fornito dall'utente che è associato all'indirizzo.
Indirizzo	street1	stringa	Prima riga fornita per l'indirizzo.
Indirizzo	street2	stringa	Seconda riga fornita per l'indirizzo. (Questo valore può essere vuoto).
Indirizzo	street3	stringa	Terza riga fornita per l'indirizzo. (Questo valore può essere vuoto).
Indirizzo	city	stringa	La città che è stata specificata per l'indirizzo.
Indirizzo	state	stringa	Provincia fornita per l'indirizzo.
Indirizzo	district	stringa	La provincia che è stata specificata per l'indirizzo.
Indirizzo	zipCode	stringa	Il codice postale che è stato specificato per l'indirizzo.
Indirizzo	CountryRegion	stringa	Il codice paese/area geografica che è stato specificato per l'indirizzo. Il valore deve essere un codice paese/area geografica ISO di due lettere, ad esempio IT.
PaymentInstrument	merchantPaymentInstrumentId	stringa	Identificatore dello strumento di pagamento. Tali informazioni sono fornite dal fornitore.
PaymentInstrument	tipo	enum	Tipo di pagamento. I valori possibili sono CreditCard, DirectDebit, PayPal, MobileBilling, OnlineBankTransfer, Invoice, MerchantGiftCard, MerchantWallet, CashOnDelivery, Paytm e CCAvenue.
PaymentInstrument	creationDate	DateTime	La data della prima immissione dello strumento di pagamento nel sistema dell'esercente. Il formato è ISO 8601.
PaymentInstrument	updateDate	DateTime	La data dell'ultimo aggiornamento dello strumento di pagamento nel sistema dell'esercente. Il formato è ISO 8601.
PaymentInstrument	state	stringa	Lo stato corrente dello strumento di pagamento nel sistema del fornitore (ad esempio, Attivo, Bloccato o Scaduto).
PaymentInstrument	cardType	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCard o DirectDebit. I valori possibili sono Visa, Mastercard, Amex, ACH, SEPA, UnionPay, Inicis, MobileBillingCarrier, Discover, AllPay, JCB e DiscoverDiners.
PaymentInstrument	holderName	stringa	Il nome dell'utente dello strumento di pagamento. Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCard o DirectDebit.
PaymentInstrument	bin	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCard o DirectDebit.
PaymentInstrument	expirationDate	stringa	La data di scadenza dello strumento di pagamento nel sistema dell'esercente. Il formato è ISO 8601. Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCard o DirectDebit.
PaymentInstrument	lastFourDigits	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCard o DirectDebit.
PaymentInstrument	posta elettronica	stringa	L'indirizzo e-mail associato allo strumento di pagamento. Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	billingAgreementId	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	payerId	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	payerStatus	stringa	Un valore che indica se PayPal ha verificato il pagante. Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	addressStatus	stringa	Un valore che indica se PayPal ha verificato l'indirizzo del pagante. Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	imei	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo MobileBilling.
PaymentInstrument \ BillingAddress	addressType	enum	Tipo di indirizzo. I valori possibili sono Primary, Billing, Shipping e Alternative. Il valore predefinito è Billing.
PaymentInstrument \ BillingAddress	firstName	stringa	Nome fornito dall'utente che è associato all'indirizzo.
PaymentInstrument \ BillingAddress	lastName	stringa	Cognome fornito dall'utente che è associato all'indirizzo.
PaymentInstrument \ BillingAddress	phoneNumber	stringa	Numero di telefono fornito dall'utente che è associato all'indirizzo.
PaymentInstrument \ BillingAddress	street1	stringa	Prima riga fornita per l'indirizzo.
PaymentInstrument \ BillingAddress	street2	stringa	Seconda riga fornita per l'indirizzo. (Questo valore può essere vuoto).
PaymentInstrument \ BillingAddress	street3	stringa	Terza riga fornita per l'indirizzo. (Questo valore può essere vuoto).
PaymentInstrument \ BillingAddress	city	stringa	La città che è stata specificata per l'indirizzo.
PaymentInstrument \ BillingAddress	state	stringa	Provincia fornita per l'indirizzo.
PaymentInstrument \ BillingAddress	district	stringa	La provincia che è stata specificata per l'indirizzo.
PaymentInstrument \ BillingAddress	zipCode	stringa	Il codice postale che è stato specificato per l'indirizzo.
PaymentInstrument \ BillingAddress	CountryRegion	stringa	Il codice paese/area geografica che è stato specificato per l'indirizzo. Il valore deve essere un codice paese/area geografica ISO di due lettere, ad esempio IT.
MarketingContext	campaignType	enum	Tipo della campagna di marketing. I valori possibili sono Direct, Email, Referral, PaidSearch, OrganicSearch, Advertising, SocialNetwork, General Marketing, Unknown, Other.
MarketingContext	trafficSource-referrer	stringa	Origine dell'utente, se nota. Se tramite segnalazione dell'utente esistente, immettere il valore MerchantUserId originale del referrer.
MarketingContext	trafficSource-referralLink	stringa	Origine dell'utente, se nota. Se tramite altri tipi di campagna invece della segnalazione dell'utente esistente, immettere il collegamento all'URL di origine.
MarketingContext	trafficSource-referralSite	stringa	Il sito di origine del traffico. I valori possibili sono Facebook, Instagram, Twitter, Bing, Google, Pinterest, WhatsApp e così via.
MarketingContext	IncentiveType	enum	Il tipo di incentivo per il nuovo utente. I valori possibili sono None, CashBack, Discount, FreeTrial, BonusPoints, Gift, Unknown, Other.
MarketingContext	incentiveOffer	stringa	Esatto nome dell'incentivo offerto. Ad esempio, $ 5 di sconto sul primo ordine, spedizione gratuita, 5000 punti.
MarketingContext	CampaignStartDate	data	La data di inizio della campagna sulla raccolta incentivi.
MarketingContext	CampaignExpireDate	data	La data di scadenza della campagna sulla raccolta incentivi.
MarketingContext	IncentiveQuantityLimit	stringa	Il limite di quantità di incentivi fissato dal commerciante. Ad esempio, al massimo tre 5000 punti per utente al giorno.

AccountCreationStatus

L'API AccountCreationStatus consente di condividere informazioni e contesto con Fraud Protection sullo stato di un evento di creazione dell'account. Questo evento è solo un evento di inserimento dati.

Oggetto	Attributo	Tipo	Descrizione
	ID tenant	stringa	TenantId è il GUID che rappresenta il tenant di Azure ActiveDirectory.
	Nome	stringa	Il valore è AP.AccountCreation.Status.
	Versione	stringa	Il valore è 0,5.
MetaData	trackingID	stringa	Identificatore dell'evento SignupStatus.
MetaData	signupId	stringa	Identificatore dell'evento Iscrizione.
MetaData	merchantTimeStamp	Data/Ora	Timestamp dell'evento.
MetaData	userId	stringa	Identificatore dell'utente. Tali informazioni sono fornite dal fornitore.
StatusDetails	statusType	enum	Il tipo di stato: Approvato, Rifiutato o In sospeso.
StatusDetails	reasonType	enum	Il tipo di motivo: richiesta abbandonata, richiesta non riuscita, richiesta riuscita, richiesta in sospeso, revisione non riuscita, revisione riuscita, revisione in sospeso o Nessuno. Il valore predefinito è Nessuno.
StatusDetails	challengeType	enum	Il tipo di stato della recensione: SMS, E-mail, Telefono, Altro o Nessuno. Il valore predefinito è Nessuno.
StatusDetails	statusDate	DateTime	Data e ora di applicazione dello stato. Il formato è ISO 8601.

AccountLogIn

L'API AccountLogIn consente di condividere informazioni e contesto con Fraud Protection su un evento di accesso in arrivo per la valutazione dei rischi.

Oggetto	Attributo	Tipo	Descrizione
	Nome	stringa	Il valore è AP.AccountLogin.
	Versione	stringa	Il valore è 0,5.
MetaData	trackingId	stringa	Identificatore dell'evento Login.
MetaData	LogInId	stringa	Identificatore dell'evento Iscrizione. (Questo valore può corrispondere al valore dell'attributo trackingId.)
MetaData	assessmentType	stringa	Il tipo di valutazione per l'evento. I valori possibili sono evaluate e protect. Se non viene specificato alcun valore, il valore predefinito è protect.
MetaData	customerLocalDate	dateTime	La data di creazione dell'evento Iscrizione nel fuso orario locale del cliente. Il formato è ISO 8601.
MetaData	merchantTimeStamp	dateTime	Timestamp dell'evento.
DeviceContext	DeviceContextId	stringa	ID sessione del cliente. Tali informazioni sono fornite dal servizio di creazione impronta digitale dispositivo di DFP.
DeviceContext	ipAddress	stringa	L'indirizzo IP del cliente, come fornito dal fornitore.
DeviceContext	provider	stringa	Il provider delle informazioni del dispositivo. I valori possibili sono 'DFPFingerprinting' e 'Merchant'. Se non viene specificato alcun valore, il valore predefinito è DFPFingerprinting.
DeviceContext	externalDeviceId	stringa	ID dispositivo del cliente, come fornito e gestito dal fornitore.
DeviceContext	externalDeviceType	stringa	Tipo di dispositivo del cliente, come fornito e gestito dal fornitore.
Utente	userId	stringa	Identificatore dell'utente. Tali informazioni sono fornite dal fornitore.
Utente	userType	stringa	Tipo di profilo dell'utente. Valori possibili: Consumer, Developer, Seller, Publisher e Tenant.
Utente	UserName	stringa	Il nome utente fornito dall'utente che è univoco nel sistema commerciale.
SSOAuthenticationProvider	authenticationProvider	stringa	Il provider di autenticazione SSO dell'utente, se diverso dal provider di autenticazione SSO del fornitore. I valori possibili sono MSA, Facebook, PSN, MerchantAuth e Google.
SSOAuthenticationProvider	displayName	stringa	Il nome visualizzato dell'utente per il provider di autenticazione SSO. Ad esempio, il nome utente di un account Microsoft, Facebook o Google.
RecentUpdate	lastTelefonoNumberUpdate	dateTime	La data/ora dell'aggiornamento o della creazione più recente di qualsiasi numero di telefono.
RecentUpdate	lastE-mailUpdate	dateTime	La data/ora dell'aggiornamento o della creazione più recente di qualsiasi indirizzo di posta elettronica.
RecentUpdate	lastAddressUpdate	dateTime	La data/ora dell'aggiornamento o della creazione più recente di qualsiasi indirizzo.
RecentUpdate	lastPaymentInstrumentUpdate	dateTime	La data/ora dell'aggiornamento o della creazione più recente di qualsiasi strumento di pagamento.
MarketingContext	campaignType	enum	Tipo della campagna di marketing. I valori possibili sono Direct, Email, Referral, PaidSearch, OrganicSearch, Advertising, SocialNetwork, General Marketing, Unknown, Other.
MarketingContext	trafficSource-referrer	stringa	Origine dell'utente, se nota. Se tramite segnalazione dell'utente esistente, immettere il valore MerchantUserId originale del referrer.
MarketingContext	trafficSource-referralLink	stringa	Origine dell'utente, se nota. Se tramite altri tipi di campagna invece della segnalazione dell'utente esistente, immettere il collegamento all'URL di origine.
MarketingContext	trafficSource-referralSite	stringa	Il sito di origine del traffico. I valori possibili sono Facebook, Instagram, Twitter, Bing, Google, Pinterest, WhatsApp e così via.
MarketingContext	IncentiveType	enum	Il tipo di incentivo per il nuovo utente. I valori possibili sono None, CashBack, Discount, FreeTrial, BonusPoints, Gift, Unknown, Other.
MarketingContext	incentiveOffer	stringa	Esatto nome dell'incentivo offerto. Ad esempio, $ 5 di sconto sul primo ordine, spedizione gratuita, 5000 punti.
MarketingContext	CampaignStartDate	data	La data di inizio della campagna sulla raccolta incentivi.
MarketingContext	CampaignExpireDate	data	La data di scadenza della campagna sulla raccolta incentivi.
MarketingContext	IncentiveQuantityLimit	stringa	Il limite di quantità di incentivi fissato dal commerciante. Ad esempio, al massimo tre 5000 punti per utente al giorno.

AccountLogInStatus

L'API AccountLogInStatus consente di condividere informazioni e contesto con Fraud Protection sullo stato di un evento di accesso dell'account. Questo evento è solo un evento di inserimento dati.

Oggetto	Attributo	Tipo	Descrizione
	Nome	stringa	Il valore è AP.AccountLogin.Status.
	Versione	stringa	Il valore è 0,5.
MetaData	trackingID	stringa	Identificatore dell'evento LoginStatus.
MetaData	logInId	stringa	Identificatore dell'evento Login.
MetaData	merchantTimeStamp	Data/Ora	Timestamp dell'evento.
MetaData	userId	stringa	Identificatore dell'utente. Tali informazioni sono fornite dal fornitore.
StatusDetails	statusType	stringa	Il tipo di stato: Approvato, Rifiutato o In sospeso.
StatusDetails	reasonType	enum	Il tipo di motivo: richiesta abbandonata, richiesta non riuscita, richiesta riuscita, richiesta in sospeso, revisione non riuscita, revisione riuscita, revisione in sospeso o Nessuno. Il valore predefinito è Nessuno.
StatusDetails	challengeType	enum	Il tipo di stato della recensione: SMS, E-mail, Telefono, Altro o Nessuno. Il valore predefinito è Nessuno.
StatusDetails	statusDate	DateTime	Data e ora di applicazione dello stato. Il formato è ISO 8601.

AccountUpdate

L'API AccountUpdate consente di condividere gli aggiornamenti delle informazioni sull'account con Fraud Protection. Ad esempio, è possibile modificare o aggiungere le seguenti informazioni: profilo utente, indirizzo, strumento di pagamento, numero di telefono, indirizzo di posta elettronica e SSO. Questo evento è solo un evento di inserimento dati.

Oggetto	Attributo	Tipo	Descrizione
	Nome	stringa	Il valore è AP.AccountUpdate.
	Versione	stringa	Il valore è 0,5.
MetaData	trackingId	stringa	Identificatore dell'evento AccountUpdate.
MetaData	SignupId	stringa	Identificatore dell'evento AccountUpdateId. (Questo valore può corrispondere al valore dell'attributo trackingId.)
MetaData	customerLocalDate	dateTime	La data di creazione dell'evento AccountUpdate nel fuso orario locale del cliente. Il formato è ISO 8601.
MetaData	merchantTimeStamp	dateTime	Timestamp dell'evento.
DeviceContext	DeviceContextId	stringa	ID sessione del cliente. Tali informazioni sono fornite dal servizio di creazione impronta digitale dispositivo di DFP.
DeviceContext	ipAddress	stringa	L'indirizzo IP del cliente, come fornito dal fornitore.
DeviceContext	provider	stringa	Il provider delle informazioni del dispositivo. I valori possibili sono 'DFPFingerprinting' e 'Merchant'. Se non viene specificato alcun valore, il valore predefinito è DFPFingerprinting.
DeviceContext	externalDeviceId	stringa	ID dispositivo del cliente, come fornito e gestito dal fornitore.
DeviceContext	externalDeviceType	stringa	Tipo di dispositivo del cliente, come fornito e gestito dal fornitore. I valori possibili sono Mobile, Computer, MerchantHardware, Tablet e GameConsole.
Utente	userId	stringa	Identificatore dell'utente. Tali informazioni sono fornite dal fornitore.
Utente	userType	stringa	Tipo di profilo dell'utente. Valori possibili: Consumer, Developer, Seller, Publisher e Tenant.
Utente	UserName	stringa	Il nome utente fornito dall'utente che è univoco nel sistema commerciale.
Utente	firstName	stringa	Nome fornito dall'utente nell'account.
Utente	lastName	stringa	Cognome fornito dall'utente nell'account.
Utente	CountryRegion	stringa	Paese o area geografica dell'utente. Il valore deve essere un codice paese/area geografica ISO di due lettere, ad esempio IT.
Utente	zipCode	stringa	Codice postale dell'utente.
Utente	timeZone	stringa	Il fuso orario dell'utente.
Utente	lingua	stringa	La lingua e l'area dell'utente, ad esempio EN-US.
Utente	membershipId	stringa	L'ID di appartenenza, se l'utente dispone già di appartenenza esistente con il fornitore.
Utente	isMembershipIdUserName	bool	Un valore Vero/Falso che indica se il valore membershipId può essere utilizzato come nome utente. Il valore predefinito è Falso.
Telefono	phoneType	enum	Tipo di numero di telefono. I valori possibili sono Primary e Alternative. Il valore predefinito è Primary.
Telefono	phoneNumber	stringa	Numero di telefono dell'utente. Il formato deve essere il prefisso del paese o dell'area geografica seguito da un trattino (-) e quindi numero di telefono, ad esempio per gli Stati Uniti, 1-1234567890.
Telefono	isTelefonoNumberValidated	bool	Valore Vero/Falso che indica se il numero di telefono fornito dall'utente è stato verificato come di proprietà dell'utente.
Telefono	phoneNumberValidatedDate	dateTime	La data di convalida del numero di telefono dell'utente. Il formato è ISO 8601.
Telefono	isTelefonoUserName	bool	Un valore Vero/Falso che indica se il numero di telefono può essere utilizzato come nome utente. Il valore predefinito è Falso.
Indirizzo di posta elettronica	emailType	enum	Tipo di indirizzo di posta elettronica. I valori possibili sono Primary e Alternative.
Messaggio e-mail	emailValue	stringa	Indirizzo e-mail dell'utente Questo valore non fa distinzione tra maiuscole e minuscole.
Indirizzo di posta elettronica	isE-mailValidated	bool	Valore Vero/Falso che indica se l'indirizzo e-mail fornito dall'utente è stato verificato come di proprietà dell'utente.
Indirizzo di posta elettronica	emailValidatedDate	dateTime	La data di convalida dell'indirizzo di posta elettronica dell'utente. Il formato è ISO 8601.
Indirizzo di posta elettronica	isE-mailUserName	bool	Un valore Vero/Falso che indica se l'indirizzo di posta elettronica può essere utilizzato come nome utente. Il valore predefinito è Falso.
SSOAuthenticationProvider	authenticationProvider	stringa	Il provider di autenticazione SSO dell'utente, se diverso dal provider di autenticazione SSO del fornitore. I valori possibili sono MSA, Facebook, PSN, MerchantAuth e Google.
SSOAuthenticationProvider	displayName	stringa	Il nome visualizzato dell'utente per il provider di autenticazione SSO (ad esempio, il nome utente da un account Microsoft, Facebook o Google).
Indirizzo	addressType	enum	Tipo di indirizzo. I valori possibili sono Primary, Billing, Shipping e Alternative. Il valore predefinito è Primary.
Indirizzo	firstName	stringa	Nome fornito dall'utente che è associato all'indirizzo.
Indirizzo	lastName	stringa	Cognome fornito dall'utente che è associato all'indirizzo.
Indirizzo	phoneNumber	stringa	Numero di telefono fornito dall'utente che è associato all'indirizzo.
Indirizzo	street1	stringa	Prima riga fornita per l'indirizzo.
Indirizzo	street2	stringa	Seconda riga fornita per l'indirizzo. (Questo valore può essere vuoto).
Indirizzo	street3	stringa	Terza riga fornita per l'indirizzo. (Questo valore può essere vuoto).
Indirizzo	city	stringa	La città che è stata specificata per l'indirizzo.
Indirizzo	state	stringa	Provincia fornita per l'indirizzo.
Indirizzo	district	stringa	La provincia che è stata specificata per l'indirizzo.
Indirizzo	zipCode	stringa	Il codice postale che è stato specificato per l'indirizzo.
Indirizzo	CountryRegion	stringa	Il codice paese/area geografica che è stato specificato per l'indirizzo. Il valore deve essere un codice paese/area geografica ISO di due lettere, ad esempio IT.
PaymentInstrument	merchantPaymentInstrumentId	stringa	Identificatore dello strumento di pagamento. Tali informazioni sono fornite dal fornitore.
PaymentInstrument	tipo	enum	Tipo di pagamento. I valori possibili sono CreditCard, DirectDebit, PayPal, MobileBilling, OnlineBankTransfer, Invoice, MerchantGiftCard, MerchantWallet, CashOnDelivery, Paytm e CCAvenue.
PaymentInstrument	creationDate	DateTime	La data della prima immissione dello strumento di pagamento nel sistema dell'esercente. Il formato è ISO 8601.
PaymentInstrument	updateDate	DateTime	La data dell'ultimo aggiornamento dello strumento di pagamento nel sistema dell'esercente. Il formato è ISO 8601.
PaymentInstrument	state	stringa	Lo stato corrente dello strumento di pagamento nel sistema del fornitore (ad esempio, Attivo, Bloccato o Scaduto).
PaymentInstrument	cardType	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCard o DirectDebit. I valori possibili sono Visa, Mastercard, Amex, ACH, SEPA, UnionPay, Inicis, MobileBillingCarrier, Discover, AllPay, JCB e DiscoverDiners.
PaymentInstrument	holderName	stringa	Il nome dell'utente dello strumento di pagamento. Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCardDirectDebit.
PaymentInstrument	bin	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCard o DirectDebit.
PaymentInstrument	expirationDate	stringa	La data di scadenza dello strumento di pagamento nel sistema dell'esercente. Il formato è ISO 8601. Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCard o DirectDebit.
PaymentInstrument	lastFourDigits	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo CreditCard o DirectDebit.
PaymentInstrument	posta elettronica	stringa	L'indirizzo e-mail associato allo strumento di pagamento. Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	billingAgreementId	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	payerId	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	payerStatus	stringa	Un valore che indica se PayPal ha verificato il pagante. Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	addressStatus	stringa	Un valore che indica se PayPal ha verificato l'indirizzo del pagante. Questo attributo viene utilizzato solo per i pagamenti di tipo PayPal.
PaymentInstrument	imei	stringa	Questo attributo viene utilizzato solo per i pagamenti di tipo MobileBilling.
PaymentInstrument \ BillingAddress	addressType	enum	Tipo di indirizzo. I valori possibili sono Primary, Billing, Shipping e Alternative. Il valore predefinito è Billing.
PaymentInstrument \ BillingAddress	firstName	stringa	Nome fornito dall'utente che è associato all'indirizzo.
PaymentInstrument \ BillingAddress	lastName	stringa	Cognome fornito dall'utente che è associato all'indirizzo.
PaymentInstrument \ BillingAddress	phoneNumber	stringa	Numero di telefono fornito dall'utente che è associato all'indirizzo.
PaymentInstrument \ BillingAddress	street1	stringa	Prima riga fornita per l'indirizzo.
PaymentInstrument \ BillingAddress	street2	stringa	Seconda riga fornita per l'indirizzo. (Questo valore può essere vuoto).
PaymentInstrument \ BillingAddress	street3	stringa	Terza riga fornita per l'indirizzo. (Questo valore può essere vuoto).
PaymentInstrument \ BillingAddress	city	stringa	La città che è stata specificata per l'indirizzo.
PaymentInstrument \ BillingAddress	state	stringa	Provincia fornita per l'indirizzo.
PaymentInstrument \ BillingAddress	district	stringa	La provincia che è stata specificata per l'indirizzo.
PaymentInstrument \ BillingAddress	zipCode	stringa	Il codice postale che è stato specificato per l'indirizzo.
PaymentInstrument \ BillingAddress	CountryRegion	stringa	Il codice paese/area geografica che è stato specificato per l'indirizzo. Il valore deve essere un codice paese/area geografica ISO di due lettere, ad esempio IT.

Etichette

L'API Etichette consente di condividere informazioni aggiuntive sugli risultati delle transazioni e degli eventi per l'addestramento del modello basato su un set aggiuntivo di segnali di frode. Queste informazioni includono i dati che si ricevono dalle banche. Questo evento è solo un evento di inserimento dati.

Categoria	Attributo	Tipo	Descrizione
	Nome	stringa	Il valore è AP.AccountLabel.
	Versione	stringa	Il valore è 0,5.
MetaData	TrackingId	Stringa	ID univoco per ogni evento/record.
MetaData	merchantTimeStamp	Data/Ora	La data nel fuso orario del fornitore. Il formato è ISO 8601.
MetaData	userId	stringa	Identificatore dell'utente. Tali informazioni sono fornite dal fornitore.
Etichetta	EventTimeStamp	Data/Ora	La data e l'ora dell'evento. I valori possibili sono la data di riaddebito e la data di revisione. Il formato è ISO 8601.
Etichetta	LabelObjectType	enum	Il tipo di etichetta: Acquisto, Creazione account, Accesso account, Aggiornamento account, Valutazione frodi personalizzata, Account, Strumento di pagamento o E-mail.
Etichetta	LabelObjectId	Stringa	L'identificatore per il tipo di oggetto: AcquistoId, AccountCreationId, AccountLoginId, AccountUpdateId, UserId, MerchantPaymentInstrumentId o E-mail.
Etichetta	LabelSource	enum	L'origine dell'etichetta: Riassegnazione cliente, Addebito, TC40SAFE, Revisione manuale, Rimborso, Analisi offline o Revisione protezione account.
Etichetta	LabelState	enum	Lo stato corrente dell'etichetta: Richiesta di informazioni accettata, Frode, Contestato, Stornato, Abuso, Richiesta inviata nuovamente, AccountCompromised o AccountNotCompromised.
Etichetta	LabelReasonCodes	enum	I codici motivo associati a ogni tipo di etichetta: Codice risposta banca/processore, Rimborso frode, Acquisizione account, Frode strumento di pagmento, Frode account, Abuso, Frode inintenzionale, Credenziali account fuoriuscite o Controlli protezione account superati.
Etichetta	Processore	Stringa	Il nome della banca o del processore di pagamento che genera le informazioni TC40 o System to Avoid Fraud Effectively (SAFE).
Etichetta	EffectiveStartDate	Data/Ora	Data in cui l'etichetta diventa valida. Il formato è ISO 8601.
Etichetta	EffectiveEndDate	Data/Ora	La data di fine per questa etichetta. Il formato è ISO 8601.