Zobrazení schémat ochrany nákupu

Tento článek popisuje schémata pro rozhraní API v reálném čase a historická data, která se hromadně nahrávají do Microsoft Dynamics 365 Fraud Protection. Informace o postupu nahrávání najdete v tématu Nahrání historických dat. Pokud se data budou ingestovat prostřednictvím aplikačního programovacího rozhraní (API), přečtěte si téma Integrace rozhraní API dynamics 365 Fraud Protection v reálném čase.

Postupujte podle těchto požadavků:

  • Soubory jsou ve formátu CSV UTF-8 (čárka, středník nebo tabulátor s oddělovači) (*.csv nebo *.tsv).
  • Maximální velikost souboru je 10 gigabajtů (GB).
  • Ve všech sloupcích jsou uchycené následující znaky: čárky/středníky, znaky nového řádku a víceřádkové znaky.
  • Sloupce datetime jsou ve formátu ISO 8601. Například v jazyce C# DateTime.UtcNow.ToString("o") by měl formát "2019-03-14T20:18:11.254Z".
  • Přesnost sloupce double (desetinná čárka) je dvě desetinná místa.

Transakce

V vyhodnocení a ochraně prostředí se používají následující schémata.

Nákupy

Atribut Typ Popis
PurchaseId String Identifikátor transakce (nebo nákupní nebo objednávky).
OriginalOrderId String Původní identifikátor objednávky pro platby opakované fakturace, jako je například měsíční fakturace předplatného.
CustomerLocalDate DateTime Datum vytvoření nákupu v místním časovém pásmu zákazníka. Formát je ISO 8601.
MerchantLocalDate DateTime Datum příjmu nákupů v místním časovém pásmu obchodníka. Formát je ISO 8601.
TotalAmount Hodnota s dvojitou přesností Celková částka účtovaná zákazníkovi včetně daně. Tyto informace poskytuje obchodník.
SalesTax Hodnota s dvojitou přesností Daň z prodeje, která byla účtována za transakci. Tyto informace poskytuje obchodník.
Měna String Měna původního nákupu jako tříznakový kód měny (například USD, který je v souladu s kódem měny OANDA). Tyto informace poskytuje obchodník.
DeviceContextId String ID relace události (poskytnuté otiskem zařízení microsoftu) nebo ID transakce, pokud relace není k dispozici.
IPAddress String IP adresa zákazníka. Tyto informace poskytuje Microsoft Device Fingerprinting.
ID uživatele String Identifikátor zákazníka. Tyto informace poskytuje obchodník. Tento atribut je povinný.
UserFirstName String Jméno zadané zákazníkem v zákaznickém účtu.
UserLastName String Příjmení zadané zákazníkem na zákaznickém účtu.
UserEmail String E-mailová adresa zákazníka. Tato hodnota nerozlišuje malá a velká písmena.
UserCreationDate DateTime Datum vytvoření účtu zákazníka. Formát je ISO 8601.
UserUpdateDate DateTime Datum poslední změny zákaznických dat. Formát je ISO 8601.
UserZipCode String PSČ zákazníka.
UserCountryCode String Země nebo oblast zákazníka. Hodnota by měla být dvoumísmenná země nebo kód oblasti (například USA).
UserTimeZone String Prázdný řetězec.
UserLanguage String Jazyk a oblast jazyka zákazníka (například EN-US).
Uživatel Telefon Číslo String Telefonní číslo zákazníka. Formát by měl být kód země nebo oblasti následovaný spojovníkem (-) a pak telefonním číslem (například: pro USA, +1-1234567890).
IsEmailValidated Logická hodnota Hodnota True/False označující, jestli byla e-mailová adresa poskytnutá zákazníkem ověřena jako vlastněná zákazníkem.
ShippingFirstName String Jméno, které bylo zadané pro adresu.
ShippingLastName String Příjmení, které bylo zadané pro adresu.
Doprava Telefon Číslo String Telefonní číslo zadané pro adresu. Formát by měl být kód země nebo oblasti následovaný spojovníkem (-) a pak telefonním číslem (například: pro USA, +1-1234567890).
Ulice1 String První řádek, který byl pro adresu zadaný.
Ulice 2 String Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Ulice 3 String Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Město String Město, které bylo poskytnuto pro adresu.
Stát String Stát nebo provincie, které byly poskytnuty pro adresu.
ZipCode String PSČ, která byla zadaná pro adresu.
CountryCode String Kód země nebo oblasti, který byl pro adresu poskytnut. Hodnota by měla být dvoumísmenný kód země nebo oblasti ISO (například USA).
Customdata Object Volitelný kontejner vlastností JSON (JavaScript Object Notation) definovaný uživatelem. Vyplní se při vytvoření instance volání rozhraní API. Na atributy lze odkazovat při vytváření nákupních pravidel.

Poznámka:

  • Podporují se následující primitivní typy: String (Unicode), Int32, UInt32, Double, Boolean a DateTime (v koordinovaném univerzálním čase (UTC) v souladu s sémantikou .NET).
  • Limit dat řetězce je 256 znaků.
  • Pro datovou část platí limit 100 vlastních atributů.
  • Neodesílejte citlivé nebo vysoce regulované datové typy. Několik příkladů:
    • Data označující chráněnou třídu (například pohlaví nebo rasu) nebo soukromé/citlivé kategorie (například náboženské názory nebo sexuální orientaci)
    • Biometrická data nebo jakákoli data související se stavem
  • Vlastní zásady uchovávání dat odpovídají zásadám uchovávání informací události nákupu (šest měsíců).

Ukázku, která ukazuje, jak používat rozhraní API pro nákup s vlastním datovým objektem v ochraně před podvody, najdete v části Ukázka vlastních dat na konci tohoto článku.

MerchantBusinessType String Obchodní nebo oborový svislý (například herní, maloobchodní, jídelní nebo sociální sítě).
MerchantIdentifier String ID obchodníka (MID) je konkrétní identifikační číslo připojené k podniku, které říká systémům zpracování plateb zapojeným do transakce, kam mají být odeslány finanční prostředky. Můžete si to představit jako adresu pro vaši firmu. Pokud například nemáte ID obchodníka, sítě, které se týkají, nebudou vědět, kam posílat vaše peníze.
MerchantCategoryCode String Kód kategorie obchodníka (MCC) je čtyřciferné číslo uvedené v ISO 18245 pro maloobchodní finanční služby. MCC slouží ke klasifikaci podnikání podle typů zboží nebo služeb, které poskytuje.
MerchantBusinessSegment String Pododdíl celkového provozu obchodníka, ve kterém existuje zavedená, samostatná produktová řada, obchodní linka nebo podřízená značka (například Xbox nebo Surface).
MerchantProductCategory String Kategorie produktů nebo služeb definovaných obchodníkem.
StoreId String Identifikátor úložiště.
StoreName String Zobrazovaný název obchodu.
StoreAddress String Úplná adresa (ulice, město, stát, zip) obchodu.
IsTest Logická hodnota Hodnota, která označuje, zda transakce je test v produkčním prostředí.
IsFreeProductIncluded Logická hodnota Hodnota, která označuje, zda je bezplatný produkt zahrnut do transakce.
IsGuestCheckout Logická hodnota Hodnota, která označuje, jestli byl nákup proveden jako host.
IsPostAuthCheck Logická hodnota Hodnota, která označuje, jestli došlo k ověření po ověření.
IsRecurringCharge Logická hodnota Hodnota, která indikuje, zda transakce byla předplatné nebo opakovaná.
RecurringChargeFrequencyInDays Hodnota s dvojitou přesností Jak často se opakované nákupy účtují, například každých 30 dní, každý půl roku, každý rok atd.
RecurringChargeStartDate DateTime Počáteční datum opakované transakce.
RecurringChargeEndDate DateTime Koncové datum opakované transakce.
IsPostpaid Logická hodnota Hodnota, která označuje, zda transakce je postpaid, nebo ne.
DiscountAmount Hodnota s dvojitou přesností Částka slevy uplatněná na transakci. Pokud například uživatel zakoupí 10 stejných ovladačů XBOX, bude tato položka číslo 1. Pokud si uživatel koupí 5 různých her a 10 stejných ovladačů XBOX, bude tato položka číslo 5+1 nebo 6.
TipAmount Hodnota s dvojitou přesností Částka tipu použitá na transakci.
DistinctItemCount Hodnota s dvojitou přesností Počet jedinečných položek na transakci.
TotalItemCount Hodnota s dvojitou přesností Celkový počet položek na transakci. Pokud například uživatel zakoupí 10 stejných řadičů XBOX, bude tato položka číslo 10. Pokud si uživatel koupí 5 různých her a 10 stejných ovladačů XBOX, bude tato položka číslo 5+10 nebo 15.
IsLowLiabilityPIType Logická hodnota Hodnota, která označuje platební nástroje s nízkou odpovědností (například Apple Pay, Alipay nebo UnionPay).
OrderType String Typ transakce (například: takeout).
IsRetryOrder Logická hodnota Hodnota, která označuje, jestli se objednávka opakovat.
Id pokusu String Identifikátor každého opakování transakce.
Datum expedice DateTime Datum odeslání objednávky.
OrderInitiatedChannel String Kanál, ve kterém byla transakce vytvořena (například AppStore, Web, MobileWeb, App, InGamePurchase).
OrderInitiatedChannelName String Název aplikace nebo adresa URL webu, kde byla transakce vytvořena.
OrderInitiatedChannelRegionORCountry String Trh, na kterém byla transakce vytvořena (například: App Market).
MerchantBusinessSubSegmentL2 String Druhá úroveň (L2) obchodní nebo oborový segment.
MidName String Název obchodníka přidružený k MID (identifikátor obchodníka).
TransactionProcessingOrder String Pořadí, ve kterém bylo posouzení podvodů provedeno během toku transakce.
RecurringSubscriptionId String Jedinečné ID pro opakovanou platbu
RecurringChargeSequence Int32 Nth (1, 2, 3...) čas, kdy došlo k opakovanému účtování poplatku pro tohoto zákazníka.
TransactionDescription String Typ zpracování transakcí
OrganizationLevel1 Object Nejvyšší úroveň hierarchie organizace.
OrganizationLevel2 Object Střední úroveň hierarchie organizace.
Organizační úroveň 3 Object Nejnižší úroveň hierarchie organizace.
ThreeDS Object Projděte si část ThreeDS.
RecipientUser Object Přečtěte si část o uživateli.
TravelOverview Object Viz oddíl TravelOverview specifické pro svislé atributy.
CloudBusiness Object Přečtěte si část Věnované svislým atributům CloudBusiness.
MembershipType String Stav nebo typ členství zákazníka. Můžete zadat různé úrovně, například Premium a Executive.
AuthenticationMethod String Způsob ověření zákazníka před nákupem nebo během nákupu.
LoginInputMethod String Způsob, jakým zákazník zadává své přihlašovací údaje.
LastPasswordUpdatedDate DateTimeOffset Při poslední aktualizaci hesla zákazníka.
FirstPurchaseDate DateTimeOffset Kdy zákazník provedl první nákup
LoginChallengeType String Typ testu výzvy a odpovědi, který byl zahájen.
HttpSignature String Digitální podpis zprávy HTTP.
HttpUserAgent String Hlavička požadavku použitá k identifikaci aplikace, operačního systému, dodavatele a/nebo verze.
BrowserHeader String Úplný seznam hlaviček požadavků odeslaných prohlížečem.
BrowserResolution String Rozlišení prohlížeče.
BrowserLanguage String Výchozí jazyková předvolba prohlížeče.
TcpSignature String Podpis aplikace TCP.
SslSignature String Podpis SSL.
EnabledCookies Logická hodnota Hodnota True/False označující, jestli jsou povolené soubory cookie.
EnabledFlash Logická hodnota Hodnota True/False označující, jestli je povolená funkce Flash.
EnabledJavaScript Logická hodnota Hodnota True/False označující, jestli je povolený JavaScript.
ScreenAspectRatio String Poměr stran prohlížeče.
ScreenColorDepth String Hloubka barvy obrazovky.
ScreenResolution String Rozlišení obrazovky zařízení v pixelech
SiteHostName String Název hostitele webu.
Operační systém String Operační systém zařízení.
OSFonts String Výchozí písmo operačního systému.
DeviceProcessor String Procesor zařízení.
ID relace String Jedinečné ID relace.
TrueIp String Skutečná IP adresa zařízení identifikovaná otiskem prstu zařízení
ProxyIp String IP adresa proxy zařízení.
DeviceId String Jedinečný identifikátor GUID na zařízení vygenerovaný otiskem prstu zařízení
Časové pásmo String Posun místního časového pásma v hodinách s ohledem na GMT
UserAgentDetails String Další podrobnosti o uživatelském agentu nebo prohlížeči
AppVersion String Verze aplikace.
BrowserPackagesList String Seznam balíčků nainstalovaných v zařízení
BuildManufacturer String Výrobce zařízení.
BuildModel String Zobrazované jméno uživatele pro koncový produkt.
BuildSdkVersion String Verze sestavení.
DataNetworkType String Typ mobilní datové sítě
DeviceModelName String Model zařízení
DeviceSystemName String Název zařízení počítače.
DeviceSystemVersion String Verze zařízení.
IsBluetoothEnabled Logická hodnota Hodnota True/False označující, jestli byla povolena funkce Bluetooth.
SimNetworkCountryISO String Kód země ISO pro poskytovatele mobilních služeb.
SimNetworkType String Typ mobilní sítě.
SystemUpTime String Doba, po kterou zařízení funguje a je k dispozici.
PaymentMethod String Kategorie způsobu platby nejvyšší úrovně.
IsLowLiabilityPIType Logická hodnota Hodnota True/False označující, zda je způsob platby nízkou odpovědností.
HolderCompanyName Logická hodnota Název organizace, která poskytuje vizitku nebo firemní kartu (jenom pro nákupy firmy).
SettlementApprovalRequired Logická hodnota Hodnota True/False označující, zda bylo schválení požadováno pro transakci SEPA.
PaymentCheckoutProvider String Poskytovatel rezervace eWallet.
BinName String Zobrazovaný název PŘIHRÁDKY.
BinCountryISO String Kód země ISO přidružený k bin.
BinCardType String Typ karty BIN.
Přidružení BinCardAssociation String Přidružení karty BIN.
BinBankGroup String Skupina bank BIN.
Měna String Kód měny pro vybraný platební nástroj.
IsInternationalMoneyTransfer Logická hodnota Hodnota True/False označující, zda došlo k mezinárodnímu převodu peněz.
BankIdentifierCode String Kód bankovního identifikátoru (kód BIC nebo SWIFT)
BankName String Název banky.
BankZipCode String Bankovní PSČ.
BankState String Bankovní stát.
BankCountryISO String Země ISO banky.
PaymentCollectionDate DateTimeOffset Odhadované datum pro shromažďování plateb (primárně používané pro poskytovatele platebních služeb).
Okamžité platbySettlement Logická hodnota Hodnota True/False označující bankovní přesměrování (používá se k podpoře plateb CSV).
AutoCaptureEnabled Logická hodnota Hodnota True/False označující, jestli byla platba automaticky zaznamenána za platby kartou. U plateb přesměrovávání se jedná pouze o ukazatel na partnerovou banku bez ohledu na to, jestli mají být prostředky automaticky nebo ne.
Accounttype String Určuje typ účtu, který se má účtovat za transakci. NEZADANÁ je výchozí hodnota. CHEQUE_ACCOUNT používá kartu jako debetní kartu. CREDIT_FACILITY používá kartu jako platební kartu.
AuthorizationType String Typ autorizace. Mastercard a Visa nyní vyžadují, aby obchodníci definovali pokusy o autorizaci buď jako předběžnou autorizaci, nebo jako konečnou autorizaci.
AuthorizationResultCode String Bankovní odpověď z rozhodnutí o autorizaci.
AuthorizationResultText String Důvody pro rozhodnutí o autorizaci, zejména pro odmítnuté nebo nevyřízené transakce.
AcquirerId String Získání identifikačního kódu instituce.
AcquirerCountryISO String Získání kódu země instituce.
CvvVerify String Označuje, jestli je ověření CVV k dispozici nebo zda bylo úspěšně ověřeno.
  • Y = úspěšně ověřeno
  • N = Nepovedlo se ověřit
  • U = Nedostupné
  • A = K dispozici, ale bez ověření
AvsVerify String Určuje, jestli je ověření adresy k dispozici nebo zda bylo úspěšně ověřeno.
  • Y = úspěšně ověřeno
  • N = Nepovedlo se ověřit
  • U = Nedostupné
  • A = K dispozici, ale bez ověření
CavVerify String Označuje, jestli je ověření pomocí držitelů karet k dispozici nebo zda je úspěšně ověřeno.
  • Y = úspěšně ověřeno
  • N = Nepovedlo se ověřit
  • U = Nedostupné
  • A = K dispozici, ale bez ověření
EncryptedCreditCardNumber String Hodnota hash nebo šifrované číslo platební karty.
OrganizationId String Jedinečný identifikátor obchodníka nebo organizace.
Název String Název organizace
ZipCode String PSČ, kde se organizace nachází.
Stát String Stav, ve kterém se organizace nachází.
CountryISO String Kód ISO země, kde se organizace nachází.
ProductBrand String Název značky produktu.
BuyItAgainOrder Logická hodnota Pravda, když uživatelé přeobjednává předchozí objednávku (ne jenom produkt z této objednávky).
PreOrderAvailabilityDate DateTimeOffset Když byl produkt poprvé k dispozici pro předobjednávku.
TerminalId String Jedinečný identifikátor prodejního terminálu.
TerminalName String Název prodejního terminálu.
IsThreeDSAuth Logická hodnota Hodnota True/False označující, zda je tato transakce ověřena prostřednictvím 3DS.
MessageCategory String Identifikuje kategorii zprávy pro konkrétní případ použití.
DeviceChannel String Označuje typ rozhraní kanálu, které se používá k zahájení transakce.
ThreeDSServerTransId String Univerzální jedinečný identifikátor transakce přiřazený serverem 3DS k identifikaci jedné transakce.
ThreeDSRequestorAuthenticationInd String Určuje typ žádosti o ověření.
ThreeRIInd String Určuje typ požadavku 3RI.
ThreeDSReqPriorAuthMethod String Mechanismus používaný držitelem karet k předchozímu ověření u žadatele 3DS.
TransStatus String Určuje, zda transakce splňuje požadavky na ověřené transakce nebo ověření účtu.
TransStatusReason String Poskytuje informace o tom, proč má pole Stav transakce zadanou hodnotu.
ThreeDSCompInd String Určuje, zda byla metoda 3DS úspěšně dokončena.
AcsChallengeMandated String Údaj o tom, zda je požadována výzva k tomu, aby transakce byla autorizovaná kvůli místním/regionálním mandátům nebo jiné proměnné.
ThreeDSRequestorChallengeInd String Určuje, zda je požadována výzva pro tuto transakci.
ChallengeCompletionInd String Ukazatel stavu cyklu výzvy služby ACS a informace o tom, jestli se výzva dokončila, nebo bude vyžadovat další zprávy.
Přijaté hodnoty:
Use String Ukazatel elektronického obchodování (ECI). Hodnota specifická pro platební systém poskytovaná službou ACS nebo DS, která indikuje výsledky pokusu o ověření držitele karty.
ShipNameIndicator String Označuje, zda název cardholderu na účtu je identický s expedičním názvem použitým pro tuto transakci.
SuspiciousAccActivity String Označuje, jestli u žadatele 3DS došlo k podezřelé aktivitě (včetně předchozích podvodů) na účtu držitelů karet.
ChAccPwChangeInd String Udává dobu, po kterou měl žadatel 3DS změnu hesla nebo resetování účtu.
ChAccAgeInd String Doba, po kterou měl držitel karet účet s žadatelem 3DS.
ProvisionAttemptsDay String Počet pokusů o přidání karty za posledních 24 hodin
Délka: Maximálně 3 znaky.

Ukázkové hodnoty:
  • 2
  • 02
  • 002
VýjimkaRaised String

Žádosti o výjimku PSD2

  • Y – vyloučeno
  • N- Není vyloučeno

PaymentInstruments

Atribut Typ Popis
PurchaseId String Identifikátor transakce (nebo nákupní nebo objednávky).
MerchantPaymentInstrumentId String Identifikátor platebního nástroje. Tyto informace poskytuje obchodník. Toto je povinný atribut.
Typ String Typ platby. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
PurchaseAmount Hodnota s dvojitou přesností Celková částka nákupu, která používá tento platební nástroj pro transakci.
Datum vytvoření DateTime Datum první položky platebního nástroje v systému obchodníka. Formát je ISO 8601.
UpdateDate DateTime Datum poslední aktualizace platebního nástroje v systému obchodníka. Formát je ISO 8601.
CardType String Tento atribut se používá pouze pro platby typu Kreditní karta .
HolderName String Jméno zákazníka platebního nástroje. Tento atribut se používá pouze pro platby typu Kreditní karta .
PŘIHRÁDKY String Tento atribut se používá pouze pro platby typu Kreditní karta .
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 Kreditní karta .
LastFourDigits String Tento atribut se používá pouze pro platby typu Kreditní karta .
Odeslat e-mailem String E-mailová adresa přidružená k platebnímu nástroji. Tento atribut se používá pouze pro platby typu Paypal .
BillingAgreementId String Tento atribut se používá pouze pro platby typu Paypal .
PayerId String Tento atribut se používá pouze pro platby typu Paypal .
PayerStatus String Hodnota, která označuje, jestli PayPal ověřil plátce. Tento atribut se používá pouze pro platby typu Paypal .
AddressStatus String Hodnota, která označuje, jestli PayPal ověřil adresu plátce. Tento atribut se používá pouze pro platby typu Paypal .
IMEI String Tento atribut se používá pouze pro platby typu Mobilepayment .
FirstName String Jméno, které bylo zadané pro adresu.
LastName String Příjmení, které bylo zadané pro adresu.
PhoneNumber String Telefonní číslo zadané pro adresu. Formát by měl být kód země nebo oblasti následovaný spojovníkem (-) a pak telefonním číslem (například: pro USA, +1-1234567890).
Ulice1 String První řádek, který byl pro adresu zadaný.
Ulice 2 String Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Ulice 3 String Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Město String Město, které bylo poskytnuto pro adresu.
Stát String Stát nebo provincie, které byly poskytnuty pro adresu.
ZipCode String PSČ, která byla zadaná pro adresu.
CountryCode String Kód země/oblasti, který byl pro adresu zadaný. Hodnota by měla být dvoumísmenný kód země nebo oblasti ISO (například USA).
PISource String Zdroj platebního nástroje (například CustomerInput, FromSavedProfile, MobilePay).

Produkty

Atribut Typ Popis
PurchaseId String Identifikátor transakce (nebo nákupní nebo objednávky).
ID produktu String Identifikátor produktu. Toto je povinný atribut.
PurchasePrice Hodnota s dvojitou přesností Cena za řádkovou položku nákupu.
Margin String Marže, která byla získána prodejem položky.
Množství Int32 Počet zakoupených položek.
ProductName String Název produktu čitelný zákazníkem.
Typ String Hodnota, která označuje, zda bylo zboží fyzické nebo digitální.
Kategorie String Kategorie produktu (například Apparel, Boty nebo Příslušenství).
Trh String Trh, na kterém je produkt nabízen. Hodnota by měla být dvoumísmenný kód země nebo oblasti ISO (například USA).
Skladová jednotka (SKU) String Skladová jednotka produktu (SKU).
SalesPrice Hodnota s dvojitou přesností Cena položky, která byla prodána s výjimkou daně. Tyto informace poskytuje obchodník.
Měna String Měna původního nákupu jako tříznakový kód měny (například USD, který je v souladu s kódem měny OANDA). Tyto informace poskytuje obchodník.
COGS Hodnota s dvojitou přesností Náklady na prodané zboží (to znamená náklady na suroviny zboží). Tyto informace poskytuje obchodník.
IsRecurring Logická hodnota Hodnota, která označuje, jestli je produkt opakovaným předplatným.
IsFree Logická hodnota Hodnota, která označuje, jestli je produkt nabízen zdarma.
Jazyk String Jazyk a oblast jazyka (například EN-US).

Chargebacks

V vyhodnocení a ochraně prostředí se používá následující schéma.

Atribut Typ Popis
ChargebackId String Identifikátor pro vrácení peněz.
Důvod String Důvod, proč ji poskytla banka.
Průběh Řetězcové Stav. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
BankEventTimestamp DateTime Časové razítko z banky. Formát je ISO 8601.
Množství Hodnota s dvojitou přesností Částka vratky.
Měna String Měna, která se používá pro částku vrácení peněz.
ID uživatele String Identifikátor zákazníka.
PurchaseId String Identifikátor transakce (nebo nákupní nebo objednávky).
MerchantLocalDate DateTime Datum příjmu nákupů v místním časovém pásmu obchodníka. Formát je ISO 8601.

Refundace

V vyhodnocení a ochraně prostředí se používá následující schéma.

Atribut Typ Popis
RefundId String Identifikátor refundace.
Důvod String Důvod poskytnutý zákazníkem.
Průběh Řetězcové Stav refundace. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
BankEventTimestamp DateTime Časové razítko z banky. Formát je ISO 8601.
Množství Hodnota s dvojitou přesností Částka refundace.
Měna String Měna použitá pro částku prodejní ceny.
ID uživatele String Identifikátor zákazníka. Toto je povinný atribut.
PurchaseId String Identifikátor transakce (nebo nákupní nebo objednávky).
MerchantLocalDate DateTime Datum ve formátu ISO 8601.

PurchaseStatus

V vyhodnocení a ochraně prostředí se používá následující schéma.

Atribut Typ Popis
PurchaseId String Identifikátor transakce (nebo nákupní nebo objednávky).
StatusType String Typ stavu. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
Datum stavu DateTime Datum a čas, kdy byl stav použit. Formát je ISO 8601.
Důvod String Důvod přechodu stavu.
MerchantLocalDate DateTime Datum ve formátu ISO 8601.

BankEvents

V vyhodnocení a ochraně prostředí se používá následující schéma.

Atribut Typ Popis
BankEventId String Identifikátor bankovní události.
Typ String Typ bankovní události. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
BankEventTimestamp DateTime Časové razítko z banky. Formát je ISO 8601.
Průběh Řetězcové Stav. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
BankResponseCode String Kód banky v odpovědi.
PaymentProcessor String Název procesoru (například FDC nebo PayPal).
MRN String Referenční číslo obchodníka (MRN), které slouží k identifikaci transakce na straně obchodníka.
POLOVINĚ String ID obchodníka (MID), které se používá pro bankovní komunikaci.
PurchaseId String Identifikátor transakce (nebo nákupní nebo objednávky).
MerchantLocalDate DateTime Datum ve formátu ISO 8601.
MerchantPaymentInstrumentId String Scénář změny s několika pi a pi
PaymentMethod String Seskupování/kategorie způsobů platby.
CardType String Typ platby.
Aktualizovaný ukazatel výkonu String Použili jste jiný PI než ten, který jste použili v nákupu?
CvvVerify String Označuje, jestli je ověření CVV k dispozici nebo zda bylo úspěšně ověřeno.
  • Y = úspěšně ověřeno
  • N = Nepovedlo se ověřit
  • U = Nedostupné
  • A = K dispozici, ale bez ověření
AvsVerify String Určuje, jestli je ověření adresy k dispozici nebo zda bylo úspěšně ověřeno.
  • Y = úspěšně ověřeno
  • N = Nepovedlo se ověřit
  • U = Nedostupné
  • A = K dispozici, ale bez ověření
CavVerify String Označuje, jestli je ověření pomocí držitelů karet k dispozici nebo zda je úspěšně ověřeno.
  • Y = úspěšně ověřeno
  • N = Nepovedlo se ověřit
  • U = Nedostupné
  • A = K dispozici, ale bez ověření
AuthorizationResultCode String Bankovní odpověď z rozhodnutí o autorizaci.
AuthorizationResultText String důvody rozhodnutí o povolení; zejména pro odmítnuté nebo čekající transakce.
ThreeDS String Přečtěte si část Koupit threeDS v listu Nákup.

Obchodní vztah

V vyhodnocení a ochraně prostředí se používají následující schémata.

UpdateAccount

Atribut Typ Popis
CustomerLocalDate DateTime Datum ve formátu ISO 8601.
ID uživatele String Identifikátor zákazníka. Toto je povinný atribut.
UsercreationDate DateTime Datum ve formátu ISO 8601.
UserupdateDate DateTime Datum ve formátu ISO 8601.
FirstName String Jméno zadané zákazníkem v zákaznickém účtu.
LastName String Příjmení zadané zákazníkem na zákaznickém účtu.
CountryCode String Země nebo oblast zákazníka. Hodnota by měla být dvoumísmenná země nebo kód oblasti (například USA).
ZipCode String PSČ zákazníka.
Časové pásmo String Tento atribut je zastaralý (zastaralý). Jako hodnotu zadejte prázdný řetězec.
Jazyk String Jazyk a oblast jazyka zákazníka (například EN-US).
PhoneNumber String Telefonní číslo zákazníka. Formát by měl být kód země/oblasti následovaný spojovníkem (-) a telefonním číslem (například: pro USA, +1-1234567890).
Odeslat e-mailem String E-mailová adresa zákazníka. Tato hodnota nerozlišuje malá a velká písmena.
IsEmailValidated Logická hodnota Hodnota, která označuje, jestli byl e-mail poskytnutý zákazníkem ověřen jako vlastněný zákazníkem.
EmailValidatedDate DateTime Datum ověření e-mailu poskytnutého zákazníkem jako vlastníka zákazníka. Formát je ISO 8601.
Is Telefon NumberValidated Logická hodnota Hodnota, která označuje, jestli bylo telefonní číslo poskytnuté zákazníkem ověřeno jako vlastněné zákazníkem.
Telefon NumberValidatedDate DateTime Datum, kdy bylo telefonní číslo poskytnuté zákazníkem ověřeno jako vlastněné zákazníkem. Formát je ISO 8601.
DeviceContextId String ID relace události (poskytnuté otiskem zařízení microsoftu) nebo ID transakce, pokud relace není k dispozici.
Poskytovatel String Hodnota, která označuje zdroj hodnoty deviceContextId : DFP Fingerprinting nebo Merchant.
DeviceContextDC String Datové centrum Microsoft Device Fingerprinting pro ID relace zákazníka.
ExternalDeviceId String ID zařízení zákazníka. Tyto informace poskytuje a zvládá obchodník.
ExternalDeviceType String Typ zařízení identifikovaný obchodníkem (například: PC nebo Mobilní zařízení).
IpAddress String IP adresa zákazníka. Tyto informace poskytuje Microsoft Device Fingerprinting.
MerchantLocalDate DateTime Datum ve formátu ISO 8601.
MembershipType String Stav nebo typ členství zákazníka.
LoginInputMethod String Metoda, pomocí které zákazník zadává své přihlašovací údaje.
LastPasswordUpdatedDate String Při poslední aktualizaci hesla zákazníka.
FirstPurchaseDate String Když zákazník provedl první nákup.
LoginChallengeType String Typ testu výzvy a odpovědi, který byl zahájen.
AddressList String Přečtěte si část Adresa nákupu.
PaymentInstrumentList String Přečtěte si část Purchase PaymentInstrumentList.
DeviceContext String Přečtěte si část Koupit DeviceContext.

UpdateAddress

Atribut Typ Popis
ID uživatele String Identifikátor zákazníka. Toto je povinný atribut.
Addresstype String Typ adresy: Fakturace, Doprava, Účet nebo Neznámý.
FirstName String Jméno, které bylo zadané pro adresu.
LastName String Příjmení, které bylo zadané pro adresu.
PhoneNumber String Telefonní číslo zadané pro adresu.
Ulice1 String První řádek, který byl pro adresu zadaný.
Ulice 2 String Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Ulice 3 String Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Město String Město, které bylo poskytnuto pro adresu.
Stát String Stát nebo provincie, které byly poskytnuty pro adresu.
District String Oblast, která byla určena pro adresu. (Tato hodnota může být prázdná.)
ZipCode String PSČ, která byla zadaná pro adresu.
CountryCode String Kód země nebo oblasti, který byl pro adresu poskytnut. Hodnota by měla být dvoumísmenný kód země nebo oblasti ISO (například USA).

UpdatePaymentInstrument

Atribut Typ Popis
ID uživatele String Identifikátor zákazníka. Toto je povinný atribut.
MerchantPaymentInstrumentId String Identifikátor platebního nástroje. Tyto informace poskytuje obchodník. Toto je povinný atribut.
PaymentInstrumenttype String Typ platby: CreditCard, Paypal, CH, SEPA, BACS, Mobilepayment, Giftcard nebo jiné.
PaymentInstrumentcreationDate DateTime Datum první položky platebního nástroje v systému obchodníka. Formát je ISO 8601.
PaymentInstrumentupdateDate DateTime Datum poslední aktualizace platebního nástroje v systému obchodníka. Formát je ISO 8601.
PaymentInstrumentState String Stav platebního nástroje: Aktivní, Blok nebo Konec platnosti.
CardType String Tento atribut se používá pouze pro platby typu Kreditní karta .
HolderName String Jméno zákazníka platebního nástroje. Tento atribut se používá pouze pro platby typu Kreditní karta .
PŘIHRÁDKY String Tento atribut se používá pouze pro platby typu Kreditní karta .
Datum vypršení platnosti String Datum vypršení platnosti platebního nástroje v systému obchodníka. Tento atribut se používá pouze pro platby typu Kreditní karta .
LastFourDigits String Tento atribut se používá pouze pro platby typu Kreditní karta .
Odeslat e-mailem String E-mailová adresa přidružená k platebnímu nástroji. Tento atribut se používá pouze pro platby typu Paypal .
BillingAgreementId String Tento atribut se používá pouze pro platby typu Paypal .
PayerId String Tento atribut se používá pouze pro platby typu Paypal .
PayerStatus String Hodnota, která označuje, jestli PayPal ověřil plátce. Tento atribut se používá pouze pro platby typu Paypal .
AddressStatus String Hodnota, která označuje, jestli PayPal ověřil adresu plátce. Tento atribut se používá pouze pro platby typu Paypal .
IMEI String Tento atribut se používá pouze pro platby typu Mobilepayment .
BillingAddressfirstName String Jméno zadané pro adresu.
BillingAddresslastName String Příjmení, které bylo zadané pro adresu.
BillingAddressphoneNumber String Telefonní číslo zadané pro adresu. Formát by měl být kód země nebo oblasti následovaný spojovníkem (-) a pak telefonním číslem (například: pro USA, +1-1234567890).
Ulice1 String První řádek, který byl pro adresu zadaný.
Ulice 2 String Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Ulice 3 String Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Město String Město, které bylo poskytnuto pro adresu.
Stát String Stát nebo provincie, které byly poskytnuty pro adresu.
District String Oblast, která byla určena pro adresu. (Tato hodnota může být prázdná.)
ZipCode String PSČ, která byla zadaná pro adresu.
CountryCode String Kód země nebo oblasti, který byl pro adresu poskytnut. Hodnota by měla být dvoumísmenný kód země nebo oblasti ISO (například USA).

Popisky

V vyhodnocení a ochraně prostředí se používá následující schéma.

Atribut Typ Popis
TrackingId String Jedinečné ID pro každou událost nebo záznam.
MerchantLocalDate DateTime Datum v časovém pásmu obchodníka. Formát je ISO 8601.
EventTimeStamp DateTime Datum a čas události. Formát je ISO 8601. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
LabelObjectType String Toto pole označuje typ štítku: Nákup, Registrace, Vlastní vyhodnocení podvodů, Účet, Platební nástroj nebo E-mail.
LabelObjectId String Toto je pole identifikátoru pro typ objektu: PurchaseId, SignupId, UserId, MerchantPaymentInstrumentId nebo Email.
Zdroj popisků String Toto pole představuje zdroj popisku.
LabelState String Toto pole označuje aktuální stav popisku. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
LabelReasonCodes String Toto pole označuje kódy důvodů přidružené ke každému typu popisku. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
Procesor String Název banky nebo zpracovatele plateb. Další informace najdete v tématu Dynamics 365 Fraud Protection API.
EffectiveStartDate DateTime Datum účinnosti tohoto popisku. Formát je ISO 8601.
EffectiveEndDate DateTime Koncové datum pro tento popisek. Formát je ISO 8601.
Množství Hodnota s dvojitou přesností Částka, která byla účtována zákazníkovi. Tyto informace poskytuje obchodník.
Měna String Měna původního nákupu jako kód měny se třemi znaky. (Příklad: USD, který je v souladu s kódem měny OANDA). Tyto informace poskytuje obchodník.

Atributy specifické pro svislé určitou

Atribut Svisle Typ Popis
TravelOverview
CarRentalIncluded Cesta Logická hodnota Hodnota True/False označující, jestli je zahrnuta půjčovna aut.
Ubytování Na samotě Cesta Logická hodnota Hodnota True/False označující, zda je zahrnuto ubytování.
Typ cesty Cesta String Kategorie nebo typ cesty.
IsRoundTrip Cesta Logická hodnota Hodnota True/False označující, jestli je cesta zaokrouhlená.
IsDiscountOffered Cesta Logická hodnota Hodnota True/False označující, jestli byla nabízena sleva.
TravelDateTime Cesta DateTimeOffset Datum a čas zahájení cesty.
ReturnDateTime Cesta DateTimeOffset Datum a čas ukončení cesty nebo vrácení.
FromCity Cesta String Město, odkud zákazník cestuje.
FromState Cesta String Stav, ze kterého zákazník cestuje.
Pochází zCountryiso Cesta String Země ISO, odkud zákazník cestuje.
FromZipCode Cesta String PSČ, ze kterého zákazník cestuje.
ToCity Cesta String Město, do kterého zákazník cestuje.
Stav Cesta String Stav, do kterého zákazník cestuje.
ToCountryiso Cesta String Země ISO, do které zákazník cestuje.
ToZipCode Cesta String PSČ, do kterého zákazník cestuje.
Doba trvání cesty Cesta String Zastaralé Nepoužívat.
IsPackagedTour Cesta Logická hodnota Hodnota True/False označující, jestli se jedná o zabalenou prohlídku.
BookingType Cesta String Typ rezervace.
WebUrl Cesta String Adresa URL, kde byla cesta rezervována.
IssueDateTime Cesta DateTimeOffset Datum a čas vydání lístků.
FlightDetails Cesta Object Přečtěte si část FlightDetails.
UbytováníDetails Cesta Object Projděte si část LodgingDetails.
CarRentalDetails Cesta Object Projděte si část CarRentalDetails.
TravelAgent Cesta Object Přečtěte si část TravelAgent.
FlightDetails
TicketNumber Cesta String Jedinečné číslo lístku.
PlaceOfIssue Cesta String Místo, kde byl lístek vydán.
IsRestrictedTicket Cesta Logická hodnota Hodnota True/False označující, jestli je lístek omezený.
RewardsOrVoucherApplied Cesta Logická hodnota Hodnota True/False označující, zda byly na objednávku použity odměny nebo poukázky.
TotalRewardsApplied Cesta int32 Celkový počet odměn, které byly uplatněny na objednávku.
TotalFees Cesta decimal Celkové poplatky uplatněné na objednávku.
Počet cestujících Cesta Int32 Celkový počet cestujících.
NumberOfStops Cesta Int32 Počet zarážek nebo přechádků pro let.
NákupčíProfileType Cesta String Profil nebo typ členství zákazníka.
IsThirdParty Cesta Logická hodnota Hodnota True/False označující, zda byla objednávka zadána prostřednictvím webu třetí strany.
IsPurchaserFrequentFlyer Cesta Logická hodnota Hodnota True/False označující, jestli je zákazník častým letákem.
FlightSegments Cesta Object Přečtěte si část FlightSegments.
Pasažéři Cesta Object Přečtěte si část Cestující.
FlightSegments
AirlineCode Cesta String Kód letecké společnosti.
AirlineName Cesta String Název letecké společnosti.
SegmentSequence Cesta Int32 Pořadové číslo dané letové noha (např. 2 pro druhou nohu letu)
TravelClass Cesta String Třída sedadla nebo kabina.
Provozovaná Cesta String Organizace provozující let.
Letu Cesta String Číslo letu.
FromAirportCode Cesta String Kód letiště, odkud letí.
ToAirportCode Cesta String Kód letiště, do kterého letí.
DepartureDateTime Cesta DateTimeOffset Datum a čas odjezdu.
ArrivalDateTime Cesta DateTimeOffset Datum a čas příjezdu.
Pochází zAirportCity Cesta String Letiště, odkud zákazník cestuje.
Pochází zAirportState Cesta String Na letišti je uvedeno, odkud zákazník cestuje.
FromAirportZipcode Cesta String Psč letiště, odkud zákazník cestuje.
Pochází zAirportCountryiso Cesta String Kód země ISO letiště, odkud zákazník cestuje.
ToAirportCity Cesta String Letiště, do kterého zákazník cestuje.
ToAirportState Cesta String Na letišti je uvedeno, kam zákazník cestuje.
ToAirportZipcode Cesta String Psč letiště, do kterého zákazník cestuje.
ToAirportCountryiso Cesta String Země ISO letiště, do které zákazník cestuje.
Cestujících
FirstName Cesta String Jméno cestujícího.
LastName Cesta String Příjmení cestujícího.
CarRentalDetails
PickupLocation Cesta String Místo vyzvednutí vozu.
PickupDateTime Cesta DateTimeOffset Datum a čas vyzvednutí vozu.
DropOffLocation Cesta String Pronájem auta odkládací místo.
DropOffDateTime Cesta DateTimeOffset Datum a čas zapůjčení vozu
DiscountProgram Cesta String Slevový program uplatněný na objednávku půjčování aut.
Typ čáry Cesta String Typ nebo kategorie vozidla.
IsPrepaid Cesta Logická hodnota Hodnota True/False označující, zda byla předplacena půjčovna aut.
InsuranceIncluded Cesta Logická hodnota Hodnota True/False označující, zda bylo pojištění zahrnuto.
Kontaktní e-mail Cesta String E-mailová adresa nájemce auta.
Kontakt Telefon Číslo Cesta String Telefonní číslo pronájem auta.
PickupAddress Cesta Object Přečtěte si část Adresa.
DropOffAddress Cesta Object Přečtěte si část Adresa.
TravelAgent
Kód agentury Cesta String Kód cestovní agentury.
AgencyName Cesta String Název cestovní kanceláře.
AgentCode Cesta String Kód cestovního agenta.
AgencyLocation Cesta Object Přečtěte si část AgentAddress.
AgentAddress
Ulice1 Cesta String První řádek zadaný pro adresu
Ulice 2 Cesta String Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Ulice 3 Cesta String Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Město Cesta String Město, které bylo poskytnuto pro adresu.
Stav Cesta String Stát nebo provincie, které byly poskytnuty pro adresu.
District Cesta String Oblast, která byla určena pro adresu.
ZipCode Cesta String PSČ, která byla zadaná pro adresu.
Země Cesta 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).
AgenturaContact Telefon Cesta String Agentura kontaktuje telefonní číslo.
AgenturaContactEmail Cesta String Kontaktní e-mailová adresa agentury.
UbytováníDetails
FolioNumber Ubytování String Jedinečný identifikátor vlastnosti ubytování.
CheckInDate Ubytování DateTimeOffset Datum přihlášení k ubytování.
CheckOutDate Ubytování DateTimeOffset Datum rezervace ubytování.
RezervaceConfirmed Ubytování Logická hodnota Hodnota True/False označující, jestli byla rezervace potvrzena.
Popisy členství Ubytování String Další podrobnosti o stavu členství zákazníka
DiscountProgram Ubytování String Slevový program uplatněný na objednávku ubytování.
AdultCount Ubytování Int32 Počet dospělých zahrnutých v pobytu.
KidCount Ubytování Int32 Počet dětí zahrnutých v pobytu.
NightsCount Ubytování Int32 Počet nocí zahrnutých v pobytu.
RoomCount Ubytování Int32 Početpokojůch
BedType Ubytování String Typ postele nebo kategorie.
RoomType Ubytování String Typ pokoje nebo kategorie.
PaymentDescription Ubytování String Další podrobnosti o platbě ubytování.
Zařízení Ubytování Object Další informace najdete v části Zařízení.
Zařízení
Název Ubytování String Název zařízení.
Typ Ubytování String Typ zařízení.
Kontakt Telefon Číslo Ubytování String Telefonní číslo použité ke kontaktování zařízení.
Kontaktní e-mail Ubytování String E-mailová adresa použitá ke kontaktování zařízení.
DailyRoomRate Ubytování decimal Denní cena za zařízení.
Měna Ubytování String Měna podporovaná zařízením.
DailyRoomTaxAmount Ubytování decimal Denní částka daně z místnosti účtovaná zařízením.
Adresa Ubytování Object Přečtěte si část Adresa.
Adresa
Ulice1 Pronájem auta String První řádek zadaný pro adresu
Ulice 2 Pronájem auta String Druhý řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Ulice 3 Pronájem auta String Třetí řádek, který byl pro adresu zadaný. (Tato hodnota může být prázdná.)
Město Pronájem auta String Město, které bylo poskytnuto pro adresu.
Stav Pronájem auta String Stát nebo provincie, které byly poskytnuty pro adresu.
District Pronájem auta String Oblast, která byla určena pro adresu.
ZipCode Pronájem auta String PSČ, která byla zadaná pro adresu.
Země Pronájem auta 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).
CloudBusiness
OrganizationId CloudBusiness String Jedinečný identifikátor cloudové služby nebo organizace.
CompanyName CloudBusiness String Název cloudové služby.
Typ společnosti CloudBusiness String Typ cloudové společnosti.
CompanySize CloudBusiness Int32 Velikost cloudové společnosti.
EntityId CloudBusiness String Jedinečný identifikátor právnické osoby v rámci organizace.
PrimaryContactFirstName CloudBusiness String Jméno primárního kontaktu pro firmu.
PrimaryContactLastName CloudBusiness String Příjmení primárního kontaktu pro firmu.
PrimaryContactEmail CloudBusiness String E-mailová adresa primárního kontaktu pro firmu.
PrimaryContact Telefon Number CloudBusiness String Telefonní číslo primárního kontaktu pro firmu.
SubscriptionCount CloudBusiness Int32 Celkový počet dostupných předplatných
CompanyAddress CloudBusiness Object Přečtěte si část Adresa.

Stažení ukázkových dat

Před použitím vlastních interních dat si můžete stáhnout naše ukázkové datové soubory a prozkoumat možnosti.

  • V případě ukázek, které můžete použít s výjimkou ochrany před únikem informací, vyberte ukázkový datový soubor ochrany před únikem informací.
  • U ukázek, které můžete použít s ochranou nákupu, vyberte Ukázkový datový soubor Pro nákup ochrany.

Ukázka vlastních dat

Následující ukázka ukazuje, jak používat rozhraní API pro nákup s vlastním datovým objektem v ochraně před podvody.

{ 
"CustomData": { 
"EngagementDuration": 120.4, 
"GamerScore": 10, 
"InApp": true, 
"MiscSampleA": "abc" 
} 
}