Schémata ochrany účtů
Tento článek popisuje schéma prostřednictvím aplikačního programovacího rozhraní (API). Další informace najdete v tématu Integrace rozhraní API Dynamics 365 Fraud Protection v reálném čase.
Vytvoření účtu
Rozhraní ACCOUNTCreation API umožňuje sdílet informace a kontext s aplikací Microsoft Dynamics 365 Fraud Protection o příchozích událostech vytváření nových účtů pro posouzení rizik.
Objekt | Atribut | Typ | Popis |
---|---|---|---|
ID tenanta | string | TenantId je identifikátor GUID představujícího tenanta Azure ActiveDirectory. | |
Název | string | Hodnota je AP. AccountCreation. | |
Verze | string | Hodnota je 0,5. | |
Metadata | trackingId | string | Identifikátor události AccountCreationId . |
Metadata | SignupId | string | Identifikátor události AccountCreationId . (Tato hodnota se může shodovat s hodnotou atributu trackingId , ale liší se od atributu userId .) |
Metadata | assessmentType | string | Typ posouzení události. Možné hodnoty se vyhodnocují a chrání. Pokud není zadána žádná hodnota, výchozí hodnota je chráněna. |
Metadata | customerLocalDate | data a času. | Datum vytvoření události AccountCreationId v místním časovém pásmu zákazníka. Formát je ISO 8601. |
Metadata | merchantTimeStamp | data a času. | Časové razítko události. |
DeviceContext | DeviceContextId | string | ID relace zákazníka. Tyto informace zvládá služba otisků prstů zařízení DFP. |
DeviceContext | ipAddress | string | IP adresa zákazníka, jak ji poskytuje obchodník. |
DeviceContext | Zprostředkovatel | string | Poskytovatel informací o zařízení. Možné hodnoty jsou DFPFingerprinting a Merchant. Pokud není zadána žádná hodnota, výchozí hodnota je DFPFingerprinting. |
DeviceContext | externalDeviceId | string | ID zařízení zákazníka, jak je poskytováno a zvládnuto obchodníkem. |
DeviceContext | externalDeviceType | string | Typ zařízení zákazníka, který je poskytován a zvládnut obchodníkem. Možné hodnoty jsou Mobile, Computer, MerchantHardware, Tablet a GameConsole. |
Uživatelská | userId | string | Identifikátor uživatele. Tyto informace poskytuje obchodník. |
Uživatelská | userType | string | Typ profilu uživatele. Možné hodnoty jsou Consumer, Developer, Seller, Publisher a Tenant. |
Uživatelská | UserName | string | Uživatelské jméno, které je v obchodním systému jedinečné. |
Uživatelská | firstName | string | Jméno zadané uživatelem v účtu. |
Uživatelská | lastName | string | Příjmení zadané uživatelem v účtu. |
Uživatelská | CountryRegion | string | Země nebo oblast uživatele. Hodnota by měla být dvoumísmenný kód země/oblasti ISO (například USA). |
Uživatelská | zipCode | string | PSČ uživatele. |
Uživatelská | timeZone | string | Časové pásmo uživatele. |
Uživatelská | jazyk | string | Jazyk a oblast uživatele (například EN-US). |
Uživatelská | membershipId | string | ID členství, pokud již uživatel má stávající členství s obchodníkem. |
Uživatelská | isMembershipIdUserName | bool | Hodnota True/False , která označuje, zda lze hodnotu membershipId použít jako uživatelské jméno. Výchozí hodnota je False. |
telefonní | phoneType | enum | Typ telefonního čísla. Možné hodnoty jsou Primární a Alternativní. Výchozí hodnota je Primární. |
telefonní | phoneNumber | string | Telefonní číslo uživatele. Formát by měl být kód země/oblasti následovaný spojovníkem (-) a telefonním číslem (například v USA, +1-1234567890). |
telefonní | isPhoneNumberValidated | bool | Hodnota True/False , která označuje, jestli bylo uživatelem zadané telefonní číslo ověřeno jako vlastněné uživatelem. |
telefonní | phoneNumberValidatedDate | data a času. | Datum ověření telefonního čísla uživatele. Formát je ISO 8601. |
telefonní | isPhoneUserName | bool | Hodnota True/False označující, jestli se telefonní číslo dá použít jako uživatelské jméno. Výchozí hodnota je False. |
emailType | enum | Typ e-mailové adresy. Možné hodnoty jsou Primární a Alternativní. | |
emailValue | string | E-mailová adresa uživatele. Tato hodnota nerozlišuje malá a velká písmena. | |
isEmailValidated | bool | Hodnota True/False označující, jestli uživatel zadal e-mailovou adresu, byla ověřena jako vlastněná uživatelem. | |
emailValidatedDate | data a času. | Datum ověření e-mailové adresy uživatele. Formát je ISO 8601. | |
isEmailUserName | bool | Hodnota True/False označující, jestli se e-mailová adresa může použít jako uživatelské jméno. Výchozí hodnota je False. | |
SSOAuthenticationProvider | authenticationProvider | string | Poskytovatel ověřování jednotného přihlašování (SSO) uživatele, pokud se liší od poskytovatele ověřování jednotného přihlašování obchodníka. Možné hodnoty jsou MSA, Facebook, PSN, MerchantAuth a Google. |
SSOAuthenticationProvider | displayName | string | Zobrazovaný název uživatele pro zprostředkovatele ověřování jednotného přihlašování (například uživatelské jméno z účtu Microsoft, Facebooku nebo Googlu). |
Adresa | addressType | enum | Typ adresy. Možné hodnoty jsou Primární, Fakturace, Doprava a Alternativní. Výchozí hodnota je Primární. |
Adresa | firstName | string | Jméno zadané uživatelem, které je přidružené k adrese. |
Adresa | lastName | string | Příjmení zadané uživatelem, které je přidružené k adrese. |
Adresa | phoneNumber | string | Telefonní číslo zadané uživatelem, které je přidružené k adrese. |
Adresa | ulice1 | string | První řádek, který byl pro adresu zadaný. |
Adresa | ulice2 | string | Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.) |
Adresa | ulice 3 | string | Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.) |
Adresa | city | string | Město, které bylo poskytnuto pro adresu. |
Adresa | state | string | Stát nebo provincie, které byly poskytnuty pro adresu. |
Adresa | okres | string | Oblast, která byla určena pro adresu. |
Adresa | zipCode | string | PSČ, která byla zadaná pro adresu. |
Adresa | CountryRegion | string | Kód země/oblasti, který byl pro adresu zadaný. Hodnota by měla být dvoumísmenný kód země/oblasti ISO (například USA). |
PaymentInstrument | merchantPaymentInstrumentId | string | Identifikátor platebního nástroje. Tyto informace poskytuje obchodník. |
PaymentInstrument | type | enum | Typ platby. Možné hodnoty jsou CreditCard, DirectDebit, PayPal, MobileBilling, OnlineBankTransfer, Invoice, MerchantGiftCard, MerchantWallet, CashOnDelivery, Paytm a CCAvenue. |
PaymentInstrument | creationDate | DateTime | Datum první položky platebního nástroje v systému obchodníka. Formát je ISO 8601. |
PaymentInstrument | updateDate | DateTime | Datum poslední aktualizace platebního nástroje v systému obchodníka. Formát je ISO 8601. |
PaymentInstrument | state | string | Aktuální stav platebního nástroje v systému obchodníka (například Aktivní, Blokováno nebo Konec platnosti). |
PaymentInstrument | cardType | string | Tento atribut se používá pouze pro platby typu CreditCard nebo DirectDebit . Možné hodnoty jsou Visa, Mastercard, Amex, ACH, SEPA, UnionPay, Inicis, MobileBillingCarrier, Discover, AllPay, JCB a DiscoverDiners. |
PaymentInstrument | holderName | string | Jméno uživatele platebního nástroje. Tento atribut se používá pouze pro platby typu CreditCard nebo DirectDebit . |
PaymentInstrument | bin | string | Tento atribut se používá pouze pro platby typu CreditCard nebo DirectDebit . |
PaymentInstrument | datum vypršení platnosti | string | Datum vypršení platnosti platebního nástroje v systému obchodníka. Formát je ISO 8601. Tento atribut se používá pouze pro platby typu CreditCard nebo DirectDebit . |
PaymentInstrument | lastFourDigits | string | Tento atribut se používá pouze pro platby typu CreditCard nebo DirectDebit . |
PaymentInstrument | string | E-mailová adresa přidružená k platebnímu nástroji. Tento atribut se používá pouze pro platby typu PayPal . | |
PaymentInstrument | billingAgreementId | string | Tento atribut se používá pouze pro platby typu PayPal . |
PaymentInstrument | payerId | string | Tento atribut se používá pouze pro platby typu PayPal . |
PaymentInstrument | payerStatus | string | Hodnota, která označuje, zda PayPal ověřil plátce. Tento atribut se používá pouze pro platby typu PayPal . |
PaymentInstrument | addressStatus | string | Hodnota, která označuje, jestli PayPal ověřila adresu plátce. Tento atribut se používá pouze pro platby typu PayPal . |
PaymentInstrument | imei | string | Tento atribut se používá pouze pro platby typu MobileBilling . |
PaymentInstrument \ BillingAddress | addressType | enum | Typ adresy. Možné hodnoty jsou Primární, Fakturace, Doprava a Alternativní. Výchozí hodnota je Fakturace. |
PaymentInstrument \ BillingAddress | firstName | string | Jméno zadané uživatelem, které je přidružené k adrese. |
PaymentInstrument \ BillingAddress | lastName | string | Příjmení zadané uživatelem, které je přidružené k adrese. |
PaymentInstrument \ BillingAddress | phoneNumber | string | Telefonní číslo zadané uživatelem, které je přidružené k adrese. |
PaymentInstrument \ BillingAddress | ulice1 | string | První řádek, který byl pro adresu zadaný. |
PaymentInstrument \ BillingAddress | ulice2 | string | Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.) |
PaymentInstrument \ BillingAddress | ulice 3 | string | Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.) |
PaymentInstrument \ BillingAddress | city | string | Město, které bylo poskytnuto pro adresu. |
PaymentInstrument \ BillingAddress | state | string | Stát nebo provincie, které byly poskytnuty pro adresu. |
PaymentInstrument \ BillingAddress | okres | string | Oblast, která byla určena pro adresu |
PaymentInstrument \ BillingAddress | zipCode | string | PSČ, která byla zadaná pro adresu. |
PaymentInstrument \ BillingAddress | CountryRegion | string | Kód země/oblasti, který byl pro adresu zadaný. Hodnota by měla být dvoumísmenný kód země/oblasti ISO (například USA). |
MarketingContext | campaignType | enum | Typ marketingové kampaně. Možné hodnoty jsou Direct, Email, Reference, PaidSearch, OrganicSearch, Advertising, SocialNetwork, General Marketing, Unknown, Other. |
MarketingContext | trafficSource-referrer | string | Zdroj tohoto uživatele, pokud je znám. Pokud prostřednictvím existujícího referenčního seznamu uživatelů, zadejte původní MerchantUserId referreru. |
MarketingContext | trafficSource-referralLink | string | Zdroj tohoto uživatele, pokud je znám. Pokud místo existujícího referenčního seznamu uživatelů používáte jiné typy kampaní, zadejte odkaz na zdrojovou adresu URL. |
MarketingContext | trafficSource-referralSite | string | Zdrojová lokalita provozu. Možné hodnoty jsou Facebook, Instagram, Twitter, Bing, Google, Pinterest, WhatsApp atd. |
MarketingContext | IncentiveType | enum | Typ pobídek pro nového uživatele Možné hodnoty jsou None, CashBack, Discount, FreeTrial, BonusPoints, Gift, Unknown, Other. |
MarketingContext | incentiveOffer | string | Přesný název nabídky pobídek. Například $ 5 off on first order, free shipping, 5000 bodů. |
MarketingContext | CampaignStartDate | datum | Datum kampaně začínající na kolekci pobídek. |
MarketingContext | CampaignExpireDate | datum | Datum vypršení platnosti kampaně v kolekci pobídek. |
MarketingContext | IncentiveQuantityLimit | string | Limit počtu pobídek nastavený obchodníkem. Například max na tři 5 000 bodů na uživatele za den. |
AccountCreationStatus
Rozhraní API AccountCreationStatus umožňuje sdílet informace a kontext s ochranou před podvody o stavu události vytvoření účtu. Tato událost je pouze událost příjmu dat.
Objekt | Atribut | Typ | Popis |
---|---|---|---|
ID tenanta | string | TenantId je identifikátor GUID představujícího tenanta Azure ActiveDirectory. | |
Název | string | Hodnota je AP. AccountCreation.Status. | |
Verze | string | Hodnota je 0,5. | |
Metadata | trackingID | string | Identifikátor události SignupStatus . |
Metadata | signupId | string | Identifikátor události registrace . |
Metadata | merchantTimeStamp | DateTime | Časové razítko události. |
Metadata | userId | string | Identifikátor uživatele. Tyto informace poskytuje obchodník. |
StatusDetails | statusType | enum | Typ stavu: Schváleno, Odmítnuto nebo Čeká na vyřízení. |
StatusDetails | reasonType | enum | Typ důvodu: opuštěné výzvy, neúspěšné výzvy, úspěšné výzvy, čekající na výzvu, kontrola se nezdařila, kontrola prošla, čeká na kontrolu nebo Žádná. Výchozí hodnota je None. |
StatusDetails | challengeType | enum | Typ kontroly: SMS, E-mail, Telefon, Jiný nebo Žádný. Výchozí hodnota je None. |
StatusDetails | statusDate | DateTime | Datum a čas, kdy byl stav použit. Formát je ISO 8601. |
AccountLogIn
Rozhraní API AccountLogIn umožňuje sdílet informace a kontext s ochranou před podvody o příchozí události přihlášení pro posouzení rizik.
Objekt | Atribut | Typ | Popis |
---|---|---|---|
Name | string | Hodnota je AP. AccountLogin. | |
Verze | string | Hodnota je 0,5. | |
Metadata | trackingId | string | Identifikátor události Login . |
Metadata | LogInId | string | Identifikátor události registrace . (Tato hodnota se může shodovat s hodnotou atributu trackingId .) |
Metadata | assessmentType | string | Typ posouzení události. Možné hodnoty se vyhodnocují a chrání. Pokud není zadána žádná hodnota, výchozí hodnota je chráněna. |
Metadata | customerLocalDate | data a času. | Datum vytvoření události registrace v místním časovém pásmu zákazníka. Formát je ISO 8601. |
Metadata | merchantTimeStamp | data a času. | Časové razítko události. |
DeviceContext | DeviceContextId | string | ID relace zákazníka. Tyto informace zvládá služba otisků prstů zařízení DFP. |
DeviceContext | ipAddress | string | IP adresa zákazníka, jak ji poskytuje obchodník. |
DeviceContext | Zprostředkovatel | string | Poskytovatel informací o zařízení. Možné hodnoty jsou DFPFingerprinting a Merchant. Pokud není zadána žádná hodnota, výchozí hodnota je DFPFingerprinting. |
DeviceContext | externalDeviceId | string | ID zařízení zákazníka, jak je poskytováno a zvládnuto obchodníkem. |
DeviceContext | externalDeviceType | string | Typ zařízení zákazníka, který je poskytován a zvládnut obchodníkem. |
Uživatelská | userId | string | Identifikátor uživatele. Tyto informace poskytuje obchodník. |
Uživatelská | userType | string | Typ profilu uživatele. Možné hodnoty jsou Consumer, Developer, Seller, Publisher a Tenant. |
Uživatelská | UserName | string | Uživatelské jméno, které je v obchodním systému jedinečné. |
SSOAuthenticationProvider | authenticationProvider | string | Poskytovatel ověřování jednotného přihlašování uživatele, pokud se liší od poskytovatele ověřování jednotného přihlašování obchodníka. Možné hodnoty jsou MSA, Facebook, PSN, MerchantAuth a Google. |
SSOAuthenticationProvider | displayName | string | Zobrazovaný název uživatele pro zprostředkovatele ověřování jednotného přihlašování. Například uživatelské jméno z účtu Microsoft, Facebooku nebo Googlu. |
RecentUpdate | lastPhoneNumberUpdate | data a času. | Datum a čas poslední aktualizace nebo vytvoření libovolného telefonního čísla. |
RecentUpdate | lastEmailUpdate | data a času. | Datum a čas poslední aktualizace nebo vytvoření libovolné e-mailové adresy. |
RecentUpdate | lastAddressUpdate | data a času. | Datum a čas poslední aktualizace nebo vytvoření libovolné adresy. |
RecentUpdate | lastPaymentInstrumentUpdate | data a času. | Datum a čas poslední aktualizace nebo vytvoření libovolného platebního nástroje. |
MarketingContext | campaignType | enum | Typ marketingové kampaně. Možné hodnoty jsou Direct, Email, Reference, PaidSearch, OrganicSearch, Advertising, SocialNetwork, General Marketing, Unknown, Other. |
MarketingContext | trafficSource-referrer | string | Zdroj tohoto uživatele, pokud je znám. Pokud prostřednictvím existujícího referenčního seznamu uživatelů, zadejte původní MerchantUserId referreru. |
MarketingContext | trafficSource-referralLink | string | Zdroj tohoto uživatele, pokud je znám. Pokud místo existujícího referenčního seznamu uživatelů používáte jiné typy kampaní, zadejte odkaz na zdrojovou adresu URL. |
MarketingContext | trafficSource-referralSite | string | Zdrojová lokalita provozu. Možné hodnoty jsou Facebook, Instagram, Twitter, Bing, Google, Pinterest, WhatsApp atd. |
MarketingContext | IncentiveType | enum | Typ pobídek pro nového uživatele Možné hodnoty jsou None, CashBack, Discount, FreeTrial, BonusPoints, Gift, Unknown, Other. |
MarketingContext | incentiveOffer | string | Přesný název nabídky pobídek. Například $ 5 off on first order, free shipping, 5000 bodů. |
MarketingContext | CampaignStartDate | datum | Datum kampaně začínající na kolekci pobídek. |
MarketingContext | CampaignExpireDate | datum | Datum vypršení platnosti kampaně v kolekci pobídek. |
MarketingContext | IncentiveQuantityLimit | string | Limit počtu pobídek nastavený obchodníkem. Například max na tři 5 000 bodů na uživatele za den. |
AccountLogInStatus
Rozhraní API AccountLogInStatus umožňuje sdílet informace a kontext s ochranou před podvody o stavu události přihlášení k účtu. Tato událost je pouze událost příjmu dat.
Objekt | Atribut | Typ | Popis |
---|---|---|---|
Name | string | Hodnota je AP. AccountLogin.Status. | |
Verze | string | Hodnota je 0,5. | |
Metadata | trackingID | string | Identifikátor události LoginStatus . |
Metadata | logInId | string | Identifikátor události Login . |
Metadata | merchantTimeStamp | DateTime | Časové razítko události. |
Metadata | userId | string | Identifikátor uživatele. Tyto informace poskytuje obchodník. |
StatusDetails | statusType | string | Typ stavu: Schváleno, Odmítnuto nebo Čeká na vyřízení. |
StatusDetails | reasonType | enum | Typ důvodu: opuštěné výzvy, neúspěšné výzvy, úspěšné výzvy, čekající na výzvu, kontrola se nezdařila, kontrola prošla, čeká na kontrolu nebo Žádná. Výchozí hodnota je None. |
StatusDetails | challengeType | enum | Typ kontroly: SMS, E-mail, Telefon, Jiný nebo Žádný. Výchozí hodnota je None. |
StatusDetails | statusDate | DateTime | Datum a čas, kdy byl stav použit. Formát je ISO 8601. |
AccountUpdate
Rozhraní API AccountUpdate umožňuje sdílet aktualizace informací o účtu s ochranou před podvody. Můžete například upravit nebo přidat následující informace: profil uživatele, adresu, platební nástroj, telefonní číslo, e-mailovou adresu a jednotné přihlašování. Tato událost je pouze událost příjmu dat.
Objekt | Atribut | Typ | Popis |
---|---|---|---|
Name | string | Hodnota je AP. AccountUpdate. | |
Verze | string | Hodnota je 0,5. | |
Metadata | trackingId | string | Identifikátor události AccountUpdate . |
Metadata | SignupId | string | Identifikátor události AccountUpdateId . (Tato hodnota se může shodovat s hodnotou atributu trackingId .) |
Metadata | customerLocalDate | data a času. | Datum vytvoření události AccountUpdate v místním časovém pásmu zákazníka. Formát je ISO 8601. |
Metadata | merchantTimeStamp | data a času. | Časové razítko události. |
DeviceContext | DeviceContextId | string | ID relace zákazníka. Tyto informace zvládá služba otisků prstů zařízení DFP. |
DeviceContext | ipAddress | string | IP adresa zákazníka, jak ji poskytuje obchodník. |
DeviceContext | Zprostředkovatel | string | Poskytovatel informací o zařízení. Možné hodnoty jsou DFPFingerprinting a Merchant. Pokud není zadána žádná hodnota, výchozí hodnota je DFPFingerprinting. |
DeviceContext | externalDeviceId | string | ID zařízení zákazníka, jak je poskytováno a zvládnuto obchodníkem. |
DeviceContext | externalDeviceType | string | Typ zařízení zákazníka, který je poskytován a zvládnut obchodníkem. Možné hodnoty jsou Mobile', Computer, MerchantHardware, Tablet a GameConsole. |
Uživatelská | userId | string | Identifikátor uživatele. Tyto informace poskytuje obchodník. |
Uživatelská | userType | string | Typ profilu uživatele. Možné hodnoty jsou Consumer, Developer, Seller, Publisher a Tenant. |
Uživatelská | UserName | string | Uživatelské jméno, které je v obchodním systému jedinečné. |
Uživatelská | firstName | string | Jméno zadané uživatelem v účtu. |
Uživatelská | lastName | string | Příjmení zadané uživatelem v účtu. |
Uživatelská | CountryRegion | string | Země nebo oblast uživatele. Hodnota by měla být dvoumísmenný kód země/oblasti ISO (například USA). |
Uživatelská | zipCode | string | PSČ uživatele. |
Uživatelská | timeZone | string | Časové pásmo uživatele. |
Uživatelská | jazyk | string | Jazyk a oblast uživatele (například EN-US). |
Uživatelská | membershipId | string | ID členství, pokud již uživatel má stávající členství s obchodníkem. |
Uživatelská | isMembershipIdUserName | bool | Hodnota True/False , která označuje, zda lze hodnotu membershipId použít jako uživatelské jméno. Výchozí hodnota je False. |
telefonní | phoneType | enum | Typ telefonního čísla. Možné hodnoty jsou Primární a Alternativní. Výchozí hodnota je Primární. |
telefonní | phoneNumber | string | Telefonní číslo uživatele. Formát by měl být kód země/oblasti následovaný spojovníkem (-) a telefonním číslem (například v USA, +1-1234567890). |
telefonní | isPhoneNumberValidated | bool | Hodnota True/False , která označuje, jestli bylo uživatelem zadané telefonní číslo ověřeno jako vlastněné uživatelem. |
telefonní | phoneNumberValidatedDate | data a času. | Datum ověření telefonního čísla uživatele. Formát je ISO 8601. |
telefonní | isPhoneUserName | bool | Hodnota True/False označující, jestli se telefonní číslo dá použít jako uživatelské jméno. Výchozí hodnota je False. |
emailType | enum | Typ e-mailové adresy. Možné hodnoty jsou Primární a Alternativní. | |
emailValue | string | E-mailová adresa uživatele. Tato hodnota nerozlišuje malá a velká písmena. | |
isEmailValidated | bool | Hodnota True/False označující, jestli uživatel zadal e-mailovou adresu, byla ověřena jako vlastněná uživatelem. | |
emailValidatedDate | data a času. | Datum ověření e-mailové adresy uživatele. Formát je ISO 8601. | |
isEmailUserName | bool | Hodnota True/False označující, jestli se e-mailová adresa může použít jako uživatelské jméno. Výchozí hodnota je False. | |
SSOAuthenticationProvider | authenticationProvider | string | Poskytovatel ověřování jednotného přihlašování uživatele, pokud se liší od poskytovatele ověřování jednotného přihlašování obchodníka. Možné hodnoty jsou MSA, Facebook, PSN, MerchantAuth a Google. |
SSOAuthenticationProvider | displayName | string | Zobrazovaný název uživatele pro zprostředkovatele ověřování jednotného přihlašování (například uživatelské jméno z účtu Microsoft, Facebooku nebo Googlu). |
Adresa | addressType | enum | Typ adresy. Možné hodnoty jsou Primární, Fakturace, Doprava a Alternativní. Výchozí hodnota je Primární. |
Adresa | firstName | string | Jméno zadané uživatelem, které je přidružené k adrese. |
Adresa | lastName | string | Příjmení zadané uživatelem, které je přidružené k adrese. |
Adresa | phoneNumber | string | Telefonní číslo zadané uživatelem, které je přidružené k adrese. |
Adresa | ulice1 | string | První řádek, který byl pro adresu zadaný. |
Adresa | ulice2 | string | Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.) |
Adresa | ulice 3 | string | Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.) |
Adresa | city | string | Město, které bylo poskytnuto pro adresu. |
Adresa | state | string | Stát nebo provincie, které byly poskytnuty pro adresu. |
Adresa | okres | string | Oblast, která byla určena pro adresu. |
Adresa | zipCode | string | PSČ, která byla zadaná pro adresu. |
Adresa | CountryRegion | string | Kód země/oblasti, který byl pro adresu zadaný. Hodnota by měla být dvoumísmenný kód země/oblasti ISO (například USA). |
PaymentInstrument | merchantPaymentInstrumentId | string | Identifikátor platebního nástroje. Tyto informace poskytuje obchodník. |
PaymentInstrument | type | enum | Typ platby. Možné hodnoty jsou CreditCard, DirectDebit, PayPal, MobileBilling, OnlineBankTransfer, Invoice, MerchantGiftCard, MerchantWallet, CashOnDelivery, Paytm a CCAvenue. |
PaymentInstrument | creationDate | DateTime | Datum první položky platebního nástroje v systému obchodníka. Formát je ISO 8601. |
PaymentInstrument | updateDate | DateTime | Datum poslední aktualizace platebního nástroje v systému obchodníka. Formát je ISO 8601. |
PaymentInstrument | state | string | Aktuální stav platebního nástroje v systému obchodníka (například Aktivní, Blokováno nebo Konec platnosti). |
PaymentInstrument | cardType | string | Tento atribut se používá pouze pro platby typu CreditCard nebo DirectDebit . Možné hodnoty jsou Visa, Mastercard, Amex, ACH, SEPA, UnionPay, Inicis, MobileBillingCarrier, Discover, AllPay, JCB a DiscoverDiners. |
PaymentInstrument | holderName | string | Jméno uživatele platebního nástroje. Tento atribut se používá pouze pro platby typů DirectDebit kreditní karty. |
PaymentInstrument | bin | string | Tento atribut se používá pouze pro platby typu CreditCard nebo DirectDebit . |
PaymentInstrument | datum vypršení platnosti | string | Datum vypršení platnosti platebního nástroje v systému obchodníka. Formát je ISO 8601. Tento atribut se používá pouze pro platby typu CreditCard nebo DirectDebit . |
PaymentInstrument | lastFourDigits | string | Tento atribut se používá pouze pro platby typu CreditCard nebo DirectDebit . |
PaymentInstrument | string | E-mailová adresa přidružená k platebnímu nástroji. Tento atribut se používá pouze pro platby typu PayPal . | |
PaymentInstrument | billingAgreementId | string | Tento atribut se používá pouze pro platby typu PayPal . |
PaymentInstrument | payerId | string | Tento atribut se používá pouze pro platby typu PayPal . |
PaymentInstrument | payerStatus | string | Hodnota, která označuje, zda PayPal ověřil plátce. Tento atribut se používá pouze pro platby typu PayPal . |
PaymentInstrument | addressStatus | string | Hodnota, která označuje, jestli PayPal ověřila adresu plátce. Tento atribut se používá pouze pro platby typu PayPal . |
PaymentInstrument | imei | string | Tento atribut se používá pouze pro platby typu MobileBilling . |
PaymentInstrument \ BillingAddress | addressType | enum | Typ adresy. Možné hodnoty jsou Primární, Fakturace, Doprava a Alternativní. Výchozí hodnota je Fakturace. |
PaymentInstrument \ BillingAddress | firstName | string | Jméno zadané uživatelem, které je přidružené k adrese. |
PaymentInstrument \ BillingAddress | lastName | string | Příjmení zadané uživatelem, které je přidružené k adrese. |
PaymentInstrument \ BillingAddress | phoneNumber | string | Telefonní číslo zadané uživatelem, které je přidružené k adrese. |
PaymentInstrument \ BillingAddress | ulice1 | string | První řádek, který byl pro adresu zadaný. |
PaymentInstrument \ BillingAddress | ulice2 | string | Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.) |
PaymentInstrument \ BillingAddress | ulice 3 | string | Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.) |
PaymentInstrument \ BillingAddress | city | string | Město, které bylo poskytnuto pro adresu. |
PaymentInstrument \ BillingAddress | state | string | Stát nebo provincie, které byly poskytnuty pro adresu. |
PaymentInstrument \ BillingAddress | okres | string | Oblast, která byla určena pro adresu. |
PaymentInstrument \ BillingAddress | zipCode | string | PSČ, která byla zadaná pro adresu. |
PaymentInstrument \ BillingAddress | CountryRegion | string | Kód země/oblasti, který byl pro adresu zadaný. Hodnota by měla být dvoumísmenný kód země/oblasti ISO (například USA). |
Popisky
Rozhraní API popisků umožňuje sdílet další informace o výsledcích transakcí a událostí pro trénování modelu, které jsou založené na další sadě signálů podvodu. Tyto informace zahrnují informace, které obdržíte od bank. Tato událost je pouze událost příjmu dat.
Kategorie | Atribut | Typ | Popis |
---|---|---|---|
Name | string | Hodnota je AP. AccountLabel. | |
Verze | string | Hodnota je 0,5. | |
Metadata | TrackingId | String | Jedinečné ID pro každou událost nebo záznam. |
Metadata | merchantTimeStamp | DateTime | Datum v časovém pásmu obchodníka. Formát je ISO 8601. |
Metadata | userId | string | Identifikátor uživatele. Tyto informace poskytuje obchodník. |
Popisek | EventTimeStamp | DateTime | Datum a čas události. Možné hodnoty jsou datum vrácení peněz a datum revize. Formát je ISO 8601. |
Popisek | LabelObjectType | enum | Typ popisku: Nákup, Vytvoření účtu, Přihlášení k účtu, Aktualizace účtu, Vlastní vyhodnocení podvodů, Účet, Platební nástroj nebo E-mail. |
Popisek | LabelObjectId | String | Pole identifikátoru pro objekt: PurchaseId, AccountCreationId, AccountLoginId, AccountUpdateId, UserId, MerchantPaymentInstrumentId nebo Email. |
Popisek | Zdroj popisků | enum | Zdroj popisku: Eskalace zákazníka, vrácení peněz, TC40_SAFE, ruční kontrola, refundace, offline analýza nebo kontrola ochrany účtu. |
Popisek | LabelState | enum | Aktuální stav popisku: Dotaz byl přijat, podvod, sporný, obrácený, zneužití, znovu odeslána žádost, účetcompromizovaný nebo AccountNotCompromised. |
Popisek | LabelReasonCodes | enum | Kódy důvodů přidružené ke každému typu popisku: Kód odpovědi zpracovatele/banky, refundace podvodů, převzetí účtu, podvod v platebním nástroji, podvody na účtu, zneužití, přátelský podvod, únik přihlašovacích údajů účtu nebo předané kontroly ochrany účtů. |
Popisek | Procesor | String | Název banky nebo platebního zpracovatele, který generuje informace TC40 nebo System, aby se zabránilo podvodům efektivně (SAFE). |
Popisek | EffectiveStartDate | DateTime | Datum, kdy se tento popisek stane efektivním. Formát je ISO 8601. |
Popisek | EffectiveEndDate | DateTime | Koncové datum pro tento popisek. Formát je ISO 8601. |