Condividi tramite

Schemi per la protezione degli account

  • Articolo

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 dei tipi DirectDebit CreditCard.
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.