Dela via

Visa inköpsskyddsscheman

  • Artikel

Den här artikeln beskriver scheman för realtids-API:er och historiska data som massuppladdas till Microsoft Dynamics 365 Fraud Protection. Information om uppladdningsproceduren finns i Ladda upp historiska data. Om data matas in via api:et (Application Programming Interface) kan du läsa Integrera API:er för Dynamics 365 Fraud Protection i realtid.

Följ dessa krav:

  • Filerna är i FORMATET CSV UTF-8 (komma, semikolon eller flikavgränsad) (*.csv eller *.tsv).
  • Den maximala filstorleken är 10 GIGABYTE (GB).
  • Följande tecken är undantagna i alla kolumner: kommatecken/semikolon, nya radtecken och flerradstecken.
  • "datetime"-kolumner är i ISO 8601-format. Till exempel skulle i C# DateTime.UtcNow.ToString("o") ha formatet "2019-03-14T20:18:11.254Z".
  • Kolumnprecisionen "double" (decimal) är två decimaler.

Transaktioner

Följande scheman används i utvärdera och skydda upplevelser.

Inköp

Attribut Typ Beskrivning
PurchaseId String Identifieraren för transaktionen (eller köpet eller beställningen).
OriginalOrderId String Den ursprungliga orderidentifieraren för betalningar av återkommande fakturering, till exempel månatlig prenumerationsfakturering.
CustomerLocalDate Datum/tid Inköpsdatumet i kundens lokala tidszon. Formatet är ISO 8601.
MerchantLocalDate Datum/tid Inköpsinmatningsdatumet i handlarens lokala tidszon. Formatet är ISO 8601.
TotalAmount Dubbel Det totala belopp som debiterades kunden inklusive skatt. Den här informationen tillhandahålls av handlaren.
SalesTax Dubbel Den moms som debiterades för transaktionen. Den här informationen tillhandahålls av handlaren.
Valuta String Valutan för det ursprungliga köpet som en valutakod med tre tecken (till exempel USD, som är anpassad till OANDA-valutakoden). Den här informationen tillhandahålls av handlaren.
DeviceContextId String Sessions-ID för händelsens session (tillhandahålls av Microsoft Device Fingerprinting) eller transaktions-ID om sessionen inte är tillgänglig.
IPAddress String Kundens IP-adress. Den här informationen tillhandahålls av Microsoft Device Fingerprinting.
AnvändarID String Kundidentifieraren. Den här informationen tillhandahålls av handlaren. Detta attribut är obligatoriskt.
UserFirstName String Kundens förnamn på kundkontot.
UserLastName String Det kundspecifika efternamnet på kundkontot.
UserEmail String Kundens e-postadress. Det här värdet är skiftlägeskänsligt.
UserCreationDate Datum/tid Skapandedatumet för kundkontot. Formatet är ISO 8601.
UserUpdateDate Datum/tid Datumet då kunddata senast ändrades. Formatet är ISO 8601.
UserZipCode String Kundens postnummer.
UserCountryCode String Kundens land eller region. Värdet ska vara en lands- eller regionkod med två bokstäver (till exempel USA).
UserTimeZone String En tom sträng.
UserLanguage String Kundens språk- och språkområde (till exempel EN-US).
Användare Telefon Number String Kundens telefonnummer. Formatet ska vara lands- eller regionkoden följt av ett bindestreck (-) och sedan telefonnumret (till exempel för USA, +1-1234567890).
IsEmailValidated Booleskt Ett true/false-värde som anger om den kundspecifika e-postadressen har verifierats som ägd av kunden.
ShippingFirstName String Det förnamn som angavs för adressen.
ShippingLastName String Det efternamn som angavs för adressen.
Frakt Telefon Nummer String Det telefonnummer som angavs för adressen. Formatet ska vara lands- eller regionkoden följt av ett bindestreck (-) och sedan telefonnumret (till exempel för USA, +1-1234567890).
Gata 1 String Den första raden som angavs för adressen.
Gata 2 String Den andra raden som angavs för adressen. (Det här värdet kan vara tomt.)
Gata 3 String Den tredje raden som angavs för adressen. (Det här värdet kan vara tomt.)
Ort String Den stad som angavs för adressen.
State String Den delstat eller provins som angavs för adressen.
ZipCode String Postnumret som angavs för adressen.
CountryCode String Lands- eller regionkoden som angavs för adressen. Värdet ska vara en iso-lands- eller regionkod med två bokstäver (till exempel USA).
CustomData Objekt En valfri användardefinierad JSON-egenskapsväska (JavaScript Object Notation). Det fylls i när ett API-anrop instansieras. Attributen kan refereras när du skapar inköpsregler.

Obs!

  • Följande primitiva typer stöds: String (Unicode), Int32, UInt32, Double, Boolean och DateTime (i Coordinated Universal Time [UTC], i överensstämmelse med .NET-semantik).
  • Strängdatagränsen är 256 tecken.
  • Det finns en gräns på 100 anpassade attribut per nyttolast.
  • Skicka inte känsliga eller strikt reglerade datatyper. Nedan följer några exempel:
    • Data som anger en skyddad klass (till exempel kön eller ras) eller privata/känsliga kategorier (till exempel religiösa åsikter eller sexuell läggning)
    • Biometriska data eller data som är relaterade till hälsa
  • Principen för anpassad datakvarhållning matchar kvarhållningsprincipen för inköpshändelsen (sex månader).

Ett exempel som visar hur du använder köp-API:er med ett anpassat dataobjekt i Bedrägeriskydd finns i avsnittet Exempel på anpassade data i slutet av den här artikeln.
MerchantBusinessType String Den vertikala verksamheten eller branschen (till exempel spel, detaljhandel, restauranger eller sociala nätverk).
MerchantIdentifier String Handels-ID (MID) är ett specifikt ID-nummer som är kopplat till ett företag som talar om för de betalningsbearbetningssystem som ingår i en transaktion var de ska skicka vilka medel. Du kan se det som en adress för ditt företag. Om du till exempel inte har något handels-ID vet de berörda nätverken inte var du ska skicka dina pengar.
MerchantCategoryCode String Handelskategorikoden (MCC) är ett fyrsiffrigt nummer som anges i ISO 18245 för finansiella detaljhandelstjänster. En MCC används för att klassificera ett företag efter de typer av varor eller tjänster som det tillhandahåller.
MerchantBusinessSegment String Underavsnittet för en handlares övergripande verksamhet där det finns en etablerad, separat produktlinje, affärslinje eller underordnat varumärke (till exempel Xbox eller Surface).
MerchantProductCategory String Den handelsdefinierade produkt- eller tjänstkategorin.
StoreId String Butiksidentifieraren.
StoreName String Butiksvisningsnamnet.
StoreAddress String Butikens fullständiga adress (gata, stad, delstat, zip).
IsTest Booleskt Ett värde som anger om transaktionen är ett test i produktion.
IsFreeProductIncluded Booleskt Ett värde som anger om en kostnadsfri produkt ingår i transaktionen.
IsGuestCheckout Booleskt Ett värde som anger om köpet gjordes som gäst.
IsPostAuthCheck Booleskt Ett värde som anger om det fanns en kontroll efter autentiseringen.
IsRecurringCharge Booleskt Ett värde som anger om transaktionen var en prenumeration/återkommande.
RecurringChargeFrequencyInDays Dubbel Hur ofta det återkommande köpet debiteras, till exempel var 30:e dag, varje halvår, varje år osv.
RecurringChargeStartDate Datum/tid Startdatumet för en återkommande transaktion.
RecurringChargeEndDate Datum/tid Slutdatum för en återkommande transaktion.
IsPostpaid Booleskt Ett värde som anger om en transaktion är postpaid eller inte.
DiscountAmount Dubbel Det rabattbelopp som tillämpas på transaktionen. Om en användare till exempel köper 10 av samma XBOX-kontrollanter blir det här objektet nummer 1. Om en användare köper 5 olika spel och 10 av samma XBOX-kontrollanter blir det här objektet nummer 5+1 eller 6.
TipAmount Dubbel Tipsbeloppet som tillämpas på transaktionen.
DistinctItemCount Dubbel Antalet distinkta/unika objekt per transaktion.
TotalItemCount Dubbel Det totala antalet objekt per transaktion. Om en användare till exempel köper 10 av samma XBOX-kontrollanter blir det här objektet nummer 10. Om en användare köper 5 olika spel och 10 av samma XBOX-kontrollanter blir det här objektet nummer 5+10 eller 15.
IsLowLiabilityPIType Booleskt Ett värde som anger betalningsinstrument med låg skuld (till exempel Apple Pay, Alipay eller UnionPay).
OrderType String Typen av transaktion (till exempel takeout).
IsRetryOrder Booleskt Ett värde som anger om ordern gjordes om.
AttemptId String Identifieraren för varje transaktion försöker igen.
ShippingDate Datum/tid Det datum då ordern levererades.
OrderInitiatedChannel String Kanalen där transaktionen skapades (till exempel AppStore, Web, MobileWeb, App, InGamePurchase).
OrderInitiatedChannelName String Appnamnet eller webb-URL:en där transaktionen skapades.
OrderInitiatedChannelRegionORCountry String Den marknad där transaktionen skapades (till exempel: Appmarknad).
MerchantBusinessSubSegmentL2 String Den andra nivån (L2) affärs- eller branschsegmentet.
Mittnamn String Det handelsnamn som är associerat med MID (handelsidentifierare).
TransactionProcessingOrder String I vilken ordning bedrägeribedömningen gjordes under transaktionsflödet.
RecurringSubscriptionId String Det unika ID:t för den återkommande avgiften
RecurringChargeSequence Int32 Den n:e (1, 2, 3...) tiden som den återkommande avgiften har inträffat för den här kunden.
TransactionDescription String Transaktionsbearbetningstypen
OrganizationLevel1 Objekt Den översta nivån i organisationshierarkin.
OrganizationLevel2 Objekt Den mellersta nivån i organisationshierarkin.
OrganizationLevel3 Objekt Den lägsta nivån i organisationshierarkin.
TreD:ar Objekt Se avsnittet ThreeDS.
MottagareAnvändare Objekt Se användaravsnittet.
TravelOverview Objekt Se avsnittet Lodräta attribut TravelOverview.
CloudBusiness Objekt Se avsnittet Lodräta attribut CloudBusiness.
MembershipType String Kundens medlemskapsstatus eller typ. Olika nivåer kan anges, till exempel Premium och Executive.
AuthenticationMethod String Det sätt på vilket kunden autentiserades före/under köpet.
LoginInputMethod String Hur kunden anger sina autentiseringsuppgifter.
LastPasswordUpdatedDate DateTimeOffset När kundens lösenord senast uppdaterades.
FirstPurchaseDate DateTimeOffset När kunden gjorde sitt första köp
LoginChallengeType String Den typ av test av utmaningssvar som initierades.
HttpSignature String Den digitala signaturen för HTTP-meddelandet.
HttpUserAgent String Begärandehuvudet som används för att identifiera programmet, operativsystemet, leverantören och/eller versionen.
BrowserHeader String Den fullständiga listan över begärandehuvuden som skickas av webbläsaren.
BrowserResolution String Webbläsarupplösningen.
BrowserLanguage String Webbläsarens standardspråkinställning.
TcpSignature String TCP-programsignaturen.
SslSignature String SSL-signaturen.
EnabledCookies Booleskt Ett sant/falskt-värde som anger om cookies är aktiverade.
EnabledFlash Booleskt Ett sant/falskt-värde som anger om Flash är aktiverat.
EnabledJavaScript Booleskt Ett sant/falskt-värde som anger om JavaScript är aktiverat.
ScreenAspectRatio String Proportioner i webbläsaren.
ScreenColorDepth String Skärmens färgdjup.
ScreenResolution String Upplösning på enhetsskärmen i bildpunkter
SiteHostName String Webbplatsens värdnamn.
OS String Enhetens operativsystem.
OSFonts String Operativsystemets standardteckensnitt.
DeviceProcessor String Enhetsprocessorn.
Sessions-ID String Det unika sessions-ID:t.
TrueIp String Verklig IP-adress för enhet som identifieras med fingeravtryck för enheten
Proxyip String IP-adress för proxyenhet.
DeviceId String Unikt GUID per enhet som genereras av enhetens fingeravtryck
Tidszon String Förskjutning av den lokala tidszonen, i timmar, med avseende på GMT
UserAgentDetails String Ytterligare information om användaragenten eller webbläsaren.
AppVersion String Programversion.
BrowserPackagesList String Lista över paket som är installerade på enheten.
BuildManufacturer String Enhetens tillverkare.
BuildModel String Användarens synliga namn för slutprodukten.
BuildSdkVersion String Byggversion.
DataNetworkType String Typ av mobilt datanätverk.
DeviceModelName String Enhetsmodell.
DeviceSystemName String Enhetens namn på datorn.
DeviceSystemVersion String Enhetsversion.
IsBluetoothEnabled Booleskt Ett sant/falskt-värde som anger om Bluetooth har aktiverats.
SimNetworkCountryISO String ISO-landskod för mobiltjänstleverantören.
SimNetworkType String Typ av mobilt nätverk.
SystemUpTime String Hur lång tid enheten har fungerat och tillgänglig.
PaymentMethod String Kategorin betalningsmetod på den översta nivån.
IsLowLiabilityPIType Booleskt Ett True/False-värde som anger om betalningsmetoden är en låg skuld.
HolderCompanyName Booleskt Namnet på den organisation som tillhandahåller företags- eller företagskortet (endast för företagsköp).
SettlementApprovalRequired Booleskt Ett sant/falskt-värde som anger om godkännande krävdes för en SEPA-transaktion.
PaymentCheckoutProvider String eWallet-utcheckningsprovidern.
BinName String Bin-visningsnamnet.
BinCountryISO String ISO-landskoden som är associerad med BIN.
BinCardType String Bin-korttypen.
BinCardAssociation String BIN-kortassociationen.
BinBankGroup String BIN-bankgruppen.
Valuta String Valutakod för det valda betalningsinstrumentet.
IsInternationalMoneyTransfer Booleskt Ett sant/falskt värde som anger om en internationell pengaöverföring har skett.
BankIdentifierCode String Bankidentifierarkod (BIC- eller SWIFT-kod)
BankName String Banknamnet.
BankZipCode String Bank-postnumret.
BankState String Bankstaten.
BankCountryISO String Bank-ISO-landet.
PaymentCollectionDate DateTimeOffset Det beräknade datumet för insamling av betalningar (används främst för betaltjänstleverantörer).
InstantPaymentSettlement Booleskt Ett sant/falskt-värde som anger bankomdirigeringar (används för att stödja CSV-betalningar).
AutoCaptureEnabled Booleskt Ett sant/falskt-värde som anger om betalningen automatiskt hämtades för kortbetalningar. För omdirigeringsbetalningar är detta helt enkelt en indikator på partnerbanken om du vill ta ut pengar automatiskt eller inte.
AccountType String Anger vilken typ av konto som ska debiteras för transaktionen. OSPECIFICERAD är standardvärdet. CHEQUE_ACCOUNT använder kortet som debetkort. CREDIT_FACILITY använder kortet som kreditkort.
AuthorizationType String Auktoriseringstypen. Mastercard och Visa kräver nu att handlarna definierar auktoriseringsförsök som antingen förauktorisering eller slutlig auktorisering.
AuthorizationResultCode String Banksvar från auktoriseringsbeslutet.
AuthorizationResultText String Orsaker till auktoriseringsbeslutet, särskilt för avvisade eller väntande transaktioner.
AcquirerId String Hämtar kod för institutionsidentifiering.
AcquirerCountryISO String Hämtar institutionens landskod.
CvvVerify String Anger om CVV-verifiering är tillgänglig och/eller har verifierats.
  • Y = har verifierats
  • N = Har inte verifierats
  • U = Ej tillgänglig
  • A = Tillgänglig, men ingen verifiering
AvsVerify String Anger om adressverifiering är tillgänglig och/eller har verifierats.
  • Y = har verifierats
  • N = Har inte verifierats
  • U = Ej tillgänglig
  • A = Tillgänglig, men ingen verifiering
CavVerify String Anger om verifiering av korthållarautentisering är tillgänglig och/eller har verifierats.
  • Y = har verifierats
  • N = Har inte verifierats
  • U = Ej tillgänglig
  • A = Tillgänglig, men ingen verifiering
EncryptedCreditCardNumber String Det hashade eller krypterade kreditkortsnumret.
OrganizationId String Den unika identifieraren för handlaren eller organisationen.
Name String Organisationens namn.
ZipCode String Postnumret där organisationen finns.
State String Tillståndet där organisationen finns.
CountryISO String Iso-landskoden för var organisationen finns.
ProductBrand String Produktens varumärke.
BuyItAgainOrder Booleskt Sant när användare beställer om en tidigare beställning (inte bara en produkt från den ordern).
PreOrderAvailabilityDate DateTimeOffset När produkten först var tillgänglig för förbeställning.
TerminalId String Den unika identifieraren för försäljningsterminalen.
TerminalName String Försäljningsplatsens terminalnamn.
IsThreeDSAuth Booleskt Ett sant/falskt-värde som anger om den här transaktionen autentiseras via 3DS.
MessageCategory String Identifierar kategorin för meddelandet för ett specifikt användningsfall.
DeviceChannel String Anger vilken typ av kanalgränssnitt som används för att initiera transaktionen.
ThreeDSServerTransId String Universellt unik transaktionsidentifierare som tilldelats av 3DS-servern för att identifiera en enskild transaktion.
ThreeDSRequestorAuthenticationInd String Anger typen av autentiseringsbegäran.
ThreeRIInd String Anger typen av 3RI-begäran.
ThreeDSReqPriorAuthMethod String Mekanism som används av korthållaren för att tidigare autentisera till 3DS Requestor.
TransStatus String Anger om en transaktion kvalificerar sig som en autentiserad transaktion eller kontoverifiering.
TransStatusReason String Innehåller information om varför fältet Transaktionsstatus har det angivna värdet.
ThreeDSCompInd String Anger om 3DS-metoden har slutförts.
AcsChallengeMandated String Uppgift om huruvida en utmaning krävs för att transaktionen ska godkännas på grund av lokala/regionala mandat eller annan variabel.
ThreeDSRequestorChallengeInd String Anger om en utmaning begärs för den här transaktionen.
ChallengeCompletionInd String Indikator på tillståndet för ACS-utmaningscykeln och om utmaningen har slutförts eller kräver ytterligare meddelanden.
Värden som accepteras:
Eci String Indikator för elektronisk handel (ECI). Betalningssystemspecifikt värde som tillhandahålls av ACS eller DS för att ange resultatet av försöket att autentisera korthållaren.
ShipNameIndicator String Anger om korthållarnamnet på kontot är identiskt med det leveransnamn som används för den här transaktionen.
SuspiciousAccActivity String Anger om 3DS-beställaren har upplevt misstänkt aktivitet (inklusive tidigare bedrägeri) på korthållarkontot.
ChAccPwChangeInd String Anger hur lång tid som gått sedan korthållarens konto hos 3DS-beställaren hade en lösenordsändring eller kontoåterställning.
ChAccAgeInd String Hur lång tid korthållaren har haft kontot hos 3DS-beställaren.
ProvisionAttemptsDay String Antal försök att lägga till kort under de senaste 24 timmarna.
Längd: Högst 3 tecken.

Exempelvärden:
  • 2
  • 02
  • 002
UndantagSbefrielse String

PSD2-undantagsbegäranden.

  • Y – undantagen
  • N– Inte undantagen

PaymentInstruments

Attribut Typ Beskrivning
PurchaseId String Identifieraren för transaktionen (eller köpet eller beställningen).
MerchantPaymentInstrumentId String Betalningsinstrumentets identifierare. Den här informationen tillhandahålls av handlaren. Det här är ett obligatoriskt attribut.
Typ String Typ av betalning. Mer information finns i Dynamics 365 Fraud Protection API.
PurchaseAmount Dubbel Det totala inköpsbeloppet som använder det här betalningsinstrumentet för transaktionen.
CreationDate Datum/tid Datum för den första posten för betalningsinstrumentet i handlarens system. Formatet är ISO 8601.
UpdateDate Datum/tid Datumet för den senaste uppdateringen för betalningsinstrumentet i handlarens system. Formatet är ISO 8601.
CardType String Det här attributet används endast för betalningar av typen CreditCard .
HolderName String Namnet på betalningsinstrumentets kund. Det här attributet används endast för betalningar av typen CreditCard .
BIN String Det här attributet används endast för betalningar av typen CreditCard .
ExpirationDate String Förfallodatum för betalningsinstrumentet i handlarens system. Formatet är ISO 8601. Det här attributet används endast för betalningar av typen CreditCard .
LastFourDigits String Det här attributet används endast för betalningar av typen CreditCard .
E-postadress String Den e-postadress som är associerad med betalningsmedlet. Det här attributet används endast för betalningar av Paypal-typen .
BillingAgreementId String Det här attributet används endast för betalningar av Paypal-typen .
PayerId String Det här attributet används endast för betalningar av Paypal-typen .
PayerStatus String Ett värde som anger om PayPal har verifierat betalaren. Det här attributet används endast för betalningar av Paypal-typen .
AddressStatus String Ett värde som anger om PayPal har verifierat betalarens adress. Det här attributet används endast för betalningar av Paypal-typen .
IMEI String Det här attributet används endast för betalningar av typen Mobilepayment .
FirstName String Det förnamn som angavs för adressen.
LastName String Det efternamn som angavs för adressen.
PhoneNumber String Det telefonnummer som angavs för adressen. Formatet ska vara lands- eller regionkoden följt av ett bindestreck (-) och sedan telefonnumret (till exempel för USA, +1-1234567890).
Gata 1 String Den första raden som angavs för adressen.
Gata 2 String Den andra raden som angavs för adressen. (Det här värdet kan vara tomt.)
Gata 3 String Den tredje raden som angavs för adressen. (Det här värdet kan vara tomt.)
Ort String Den stad som angavs för adressen.
State String Den delstat eller provins som angavs för adressen.
ZipCode String Postnumret som angavs för adressen.
CountryCode String Lands-/regionkoden som angavs för adressen. Värdet ska vara en iso-lands- eller regionkod med två bokstäver (till exempel USA).
PISource String Betalningsinstrumentkällan (till exempel: CustomerInput, FromSavedProfile, MobilePay).

Produkter

Attribut Typ Beskrivning
PurchaseId String Identifieraren för transaktionen (eller köpet eller beställningen).
Produkt-ID String Produktidentifieraren. Det här är ett obligatoriskt attribut.
PurchasePrice Dubbel Priset för radartikeln i köpet.
Marginal String Den marginal som erhållits vid försäljningen av posten.
Kvantitet Int32 Antalet artiklar som har köpts.
ProductName String Det kundläsbara produktnamnet.
Typ String Ett värde som anger om varorna var fysiska eller digitala.
Kategori String Produktkategorin (till exempel kläder, skor eller tillbehör).
Marknad String Marknaden där produkten erbjuds. Värdet ska vara en iso-lands- eller regionkod med två bokstäver (till exempel USA).
Sku String Produktens lagerhållningsenhet (SKU).
SalesPrice Dubbel Priset för den artikel som såldes exklusive skatt. Den här informationen tillhandahålls av handlaren.
Valuta String Valutan för det ursprungliga köpet som en valutakod med tre tecken (till exempel USD, som är anpassad till OANDA-valutakoden). Den här informationen tillhandahålls av handlaren.
KSV Dubbel Kostnaden för sålda varor (dvs. råvarans kostnad). Den här informationen tillhandahålls av handlaren.
IsRecurring Booleskt Ett värde som anger om produkten är en återkommande prenumeration.
IsFree Booleskt Ett värde som anger om produkten erbjuds kostnadsfritt.
Språk String Språk- och språkområdet (till exempel EN-US).

Återkrav

Följande schema används i utvärdera och skydda upplevelser.

Attribut Typ Beskrivning
ChargebackId String Återbetalningsidentifieraren.
Anledning String Anledningen till detta från banken.
Status String Status. Mer information finns i Dynamics 365 Fraud Protection API.
BankEventTimestamp Datum/tid Tidsstämpeln från banken. Formatet är ISO 8601.
Belopp Dubbel Återbetalningsbeloppet.
Valuta String Den valuta som används för återbetalningsbeloppet.
AnvändarID String Kundidentifieraren.
PurchaseId String Identifieraren för transaktionen (eller köpet eller beställningen).
MerchantLocalDate Datum/tid Inköpsinmatningsdatumet i handlarens lokala tidszon. Formatet är ISO 8601.

Återbetalningar

Följande schema används i utvärdera och skydda upplevelser.

Attribut Typ Beskrivning
RefundId String Återbetalningsidentifieraren.
Anledning String Orsaken till kunden.
Status String Återbetalningsstatus. Mer information finns i Dynamics 365 Fraud Protection API.
BankEventTimestamp Datum/tid Tidsstämpeln från banken. Formatet är ISO 8601.
Belopp Dubbel Återbetalningsbeloppet.
Valuta String Den valuta som används för försäljningsprisbeloppet.
AnvändarID String Kundidentifieraren. Det här är ett obligatoriskt attribut.
PurchaseId String Identifieraren för transaktionen (eller köpet eller beställningen).
MerchantLocalDate Datum/tid Ett datum i ISO 8601-format.

PurchaseStatus

Följande schema används i utvärdera och skydda upplevelser.

Attribut Typ Beskrivning
PurchaseId String Identifieraren för transaktionen (eller köpet eller beställningen).
StatusType String Typ av status. Mer information finns i Dynamics 365 Fraud Protection API.
StatusDate Datum/tid Datum och tid då statusen tillämpades. Formatet är ISO 8601.
Anledning String Orsaken till statusövergången.
MerchantLocalDate Datum/tid Ett datum i ISO 8601-format.

BankEvents

Följande schema används i utvärdera och skydda upplevelser.

Attribut Typ Beskrivning
BankEventId String Bankhändelseidentifieraren.
Typ String Bankhändelsetypen. Mer information finns i Dynamics 365 Fraud Protection API.
BankEventTimestamp Datum/tid Tidsstämpeln från banken. Formatet är ISO 8601.
Status String Status. Mer information finns i Dynamics 365 Fraud Protection API.
BankResponseCode String Bankkoden för svaret.
PaymentProcessor String Processornamnet (till exempel: FDC eller PayPal).
MRN String Det referensnummer för säljare (MRN) som används för att identifiera transaktionen på handelssidan.
MITTEN String Det handels-ID (MID) som används för bankkommunikation.
PurchaseId String Identifieraren för transaktionen (eller köpet eller beställningen).
MerchantLocalDate Datum/tid Ett datum i ISO 8601-format.
MerchantPaymentInstrumentId String Scenario för ändring av flera PI-scenarion och PI-ändringar.
PaymentMethod String Gruppering/kategorier av betalningsmetoder.
CardType String Typ av betalning.
UppdateradPI String Har du använt en annan PI än den i Köp?
CvvVerify String Anger om CVV-verifiering är tillgänglig och/eller har verifierats.
  • Y = har verifierats
  • N = Har inte verifierats
  • U = Ej tillgänglig
  • A = Tillgänglig, men ingen verifiering
AvsVerify String Anger om adressverifiering är tillgänglig och/eller har verifierats.
  • Y = har verifierats
  • N = Har inte verifierats
  • U = Ej tillgänglig
  • A = Tillgänglig, men ingen verifiering
CavVerify String Anger om verifiering av korthållarautentisering är tillgänglig och/eller har verifierats.
  • Y = har verifierats
  • N = Har inte verifierats
  • U = Ej tillgänglig
  • A = Tillgänglig, men ingen verifiering
AuthorizationResultCode String Banksvar från auktoriseringsbeslutet.
AuthorizationResultText String Orsaker till auktoriseringsbeslutet. särskilt för avvisade eller väntande transaktioner.
TreD:ar String Se avsnittet Köp treDS i inköpsdokumentet.

Konto

Följande scheman används i utvärdera och skydda upplevelser.

UpdateAccount

Attribut Typ Beskrivning
CustomerLocalDate Datum/tid Ett datum i ISO 8601-format.
AnvändarID String Kundidentifieraren. Det här är ett obligatoriskt attribut.
UsercreationDate Datum/tid Ett datum i ISO 8601-format.
UserupdateDate Datum/tid Ett datum i ISO 8601-format.
FirstName String Kundens förnamn på kundkontot.
LastName String Det kundspecifika efternamnet på kundkontot.
CountryCode String Kundens land eller region. Värdet ska vara en lands- eller regionkod med två bokstäver (till exempel USA).
ZipCode String Kundens postnummer.
Tidszon String Det här attributet är föråldrat (inaktuellt). Ange en tom sträng som värde.
Språk String Kundens språk- och språkområde (till exempel EN-US).
PhoneNumber String Kundens telefonnummer. Formatet ska vara lands-/regionkoden följt av ett bindestreck (-) och sedan telefonnumret (till exempel för USA, +1-1234567890).
E-postadress String Kundens e-postadress. Det här värdet är skiftlägeskänsligt.
IsEmailValidated Booleskt Ett värde som anger om kundens e-post har verifierats som ägd av kunden.
EmailValidatedDate Datum/tid Det datum då kundens e-post verifierades som ägd av kunden. Formatet är ISO 8601.
Is Telefon NumberValidated Booleskt Ett värde som anger om kundens telefonnummer har verifierats som ägt av kunden.
Telefon NumberValidatedDate Datum/tid Det datum då kundens telefonnummer verifierades som ägt av kunden. Formatet är ISO 8601.
DeviceContextId String Sessions-ID för händelsens session (tillhandahålls av Microsoft Device Fingerprinting) eller transaktions-ID om sessionen inte är tillgänglig.
Provider String Ett värde som anger källan till värdet deviceContextId : DFP Fingerprinting eller Merchant.
DeviceContextDC String Microsoft Device Fingerprinting-datacentret för kundens sessions-ID.
ExternalDeviceId String Kundens enhets-ID. Den här informationen tillhandahålls och hanteras av handlaren.
ExternalDeviceType String Enhetstypen som identifieras av handlaren (till exempel pc eller mobil enhet).
Ip String Kundens IP-adress. Den här informationen tillhandahålls av Microsoft Device Fingerprinting.
MerchantLocalDate Datum/tid Ett datum i ISO 8601-format.
MembershipType String Kundens medlemskapsstatus eller typ.
LoginInputMethod String Metoden som kunden använder för att ange sina autentiseringsuppgifter.
LastPasswordUpdatedDate String När kundens lösenord senast uppdaterades.
FirstPurchaseDate String När kunden gjorde sitt första köp.
LoginChallengeType String Den typ av test av utmaningssvar som initierades.
Adresslista String Se avsnittet Inköpsadress.
PaymentInstrumentList String Se avsnittet Köp PaymentInstrumentList.
DeviceContext String Se avsnittet Köp enhetKontext.

UpdateAddress

Attribut Typ Beskrivning
AnvändarID String Kundidentifieraren. Det här är ett obligatoriskt attribut.
Adresstyp String Adresstypen: Fakturering, Leverans, Konto eller Okänd.
FirstName String Det förnamn som angavs för adressen.
LastName String Det efternamn som angavs för adressen.
PhoneNumber String Det telefonnummer som angavs för adressen.
Gata 1 String Den första raden som angavs för adressen.
Gata 2 String Den andra raden som angavs för adressen. (Det här värdet kan vara tomt.)
Gata 3 String Tredje raden som angavs för adressen. (Det här värdet kan vara tomt.)
Ort String Den stad som angavs för adressen.
State String Den delstat eller provins som angavs för adressen.
Distrikt String Distriktet som angavs för adressen. (Det här värdet kan vara tomt.)
ZipCode String Postnumret som angavs för adressen.
CountryCode String Lands- eller regionkoden som angavs för adressen. Värdet ska vara en iso-lands- eller regionkod med två bokstäver (till exempel USA).

UpdatePaymentInstrument

Attribut Typ Beskrivning
AnvändarID String Kundidentifieraren. Det här är ett obligatoriskt attribut.
MerchantPaymentInstrumentId String Betalningsinstrumentets identifierare. Den här informationen tillhandahålls av handlaren. Det här är ett obligatoriskt attribut.
PaymentInstrumenttype String Typ av betalning: Kreditkort, Paypal, CH, SEPA, BACS, Mobilepayment, Giftcard eller annat.
PaymentInstrumentcreationDate Datum/tid Datum för den första posten för betalningsinstrumentet i handlarens system. Formatet är ISO 8601.
PaymentInstrumentupdateDate Datum/tid Datumet för den senaste uppdateringen för betalningsinstrumentet i handlarens system. Formatet är ISO 8601.
PaymentInstrumentState String Betalningsmedlets tillstånd: Aktiv, Blockera eller Förfalla.
CardType String Det här attributet används endast för betalningar av typen CreditCard .
HolderName String Namnet på betalningsinstrumentets kund. Det här attributet används endast för betalningar av typen CreditCard .
BIN String Det här attributet används endast för betalningar av typen CreditCard .
ExpirationDate String Förfallodatum för betalningsinstrumentet i handlarens system. Det här attributet används endast för betalningar av typen CreditCard .
LastFourDigits String Det här attributet används endast för betalningar av typen CreditCard .
E-postadress String Den e-postadress som är associerad med betalningsmedlet. Det här attributet används endast för betalningar av Paypal-typen .
BillingAgreementId String Det här attributet används endast för betalningar av Paypal-typen .
PayerId String Det här attributet används endast för betalningar av Paypal-typen .
PayerStatus String Ett värde som anger om PayPal har verifierat betalaren. Det här attributet används endast för betalningar av Paypal-typen .
AddressStatus String Ett värde som anger om PayPal har verifierat betalarens adress. Det här attributet används endast för betalningar av Paypal-typen .
IMEI String Det här attributet används endast för betalningar av typen Mobilepayment .
BillingAddressfirstName String Det förnamn som angavs för adressen.
BillingAddresslastName String Det efternamn som angavs för adressen.
BillingAddressphoneNumber String Det telefonnummer som angavs för adressen. Formatet ska vara lands- eller regionkoden följt av ett bindestreck (-) och sedan telefonnumret (till exempel för USA, +1-1234567890).
Gata 1 String Den första raden som angavs för adressen.
Gata 2 String Den andra raden som angavs för adressen. (Det här värdet kan vara tomt.)
Gata 3 String Tredje raden som angavs för adressen. (Det här värdet kan vara tomt.)
Ort String Den stad som angavs för adressen.
State String Den delstat eller provins som angavs för adressen.
Distrikt String Distriktet som angavs för adressen. (Det här värdet kan vara tomt.)
ZipCode String Postnumret som angavs för adressen.
CountryCode String Lands- eller regionkoden som angavs för adressen. Värdet ska vara en iso-lands- eller regionkod med två bokstäver (till exempel USA).

Etiketter

Följande schema används i utvärdera och skydda upplevelser.

Attribut Typ Beskrivning
TrackingId String Unikt ID för varje händelse/post.
MerchantLocalDate Datum/tid Datumet i handlarens tidszon. Formatet är ISO 8601.
EventTimeStamp Datum/tid Datum och tid för händelsen. Formatet är ISO 8601. Mer information finns i Dynamics 365 Fraud Protection API.
LabelObjectType String Det här fältet anger typen av etikett: Köp, Registrering, Anpassad bedrägeriutvärdering, Konto, Betalningsinstrument eller E-post.
LabelObjectId String Det här är ett ID-fält för typen av objekt: PurchaseId, SignupId, UserId, MerchantPaymentInstrumentId eller E-post.
Etikettkälla String Det här fältet representerar etikettens källa.
LabelState String Det här fältet anger etikettens aktuella status. Mer information finns i Dynamics 365 Fraud Protection API.
LabelReasonCodes String Det här fältet anger de orsakskoder som är associerade med varje typ av etikett. Mer information finns i Dynamics 365 Fraud Protection API.
Processor String Namnet på bank- eller betalningsprocessorn. Mer information finns i Dynamics 365 Fraud Protection API.
EffectiveStartDate Datum/tid Det datum från vilket den här etiketten gäller. Formatet är ISO 8601.
EffectiveEndDate Datum/tid Slutdatum för den här etiketten. Formatet är ISO 8601.
Belopp Dubbel Det belopp som debiterades kunden. Den här informationen tillhandahålls av handlaren.
Valuta String Valutan för det ursprungliga köpet som en valutakod med tre tecken. (Till exempel USD, som är justerat med OANDA-valutakoden). Den här informationen tillhandahålls av handlaren.

Lodräta attribut

Attribut Lodrätt Typ Beskrivning
TravelOverview
CarRentalIncluded Resor Booleskt Ett sant/falskt värde som anger om en biluthyrning ingår.
LogiInkluderat Resor Booleskt Ett sant/falskt-värde som anger om logi ingår.
TravelType Resor String Resekategori eller typ.
IsRoundTrip Resor Booleskt Ett sant/falskt-värde som anger om resan är tur och retur.
IsDiscountOffered Resor Booleskt Ett sant/falskt värde som anger om en rabatt erbjöds.
TravelDateTime Resor DateTimeOffset Datum och tid för resstart.
ReturnDateTime Resor DateTimeOffset Datum och tid för reseslut eller retur.
FromCity Resor String Den stad där kunden reser från.
FromState Resor String Det tillstånd som kunden reser från.
FromCountryISO Resor String Det ISO-land där kunden reser från.
FromZipCode Resor String Postnumret som kunden reser från.
ToCity Resor String Den stad där kunden reser till.
ToState Resor String Det tillstånd som kunden reser till.
ToCountryISO Resor String Det ISO-land där kunden reser till.
ToZipCode Resor String Postnumret som kunden reser till.
TravelDuration Resor String Inaktuell. Använd inte.
IsPackagedTour Resor Booleskt Ett sant/falskt-värde som anger om det här var en paketerad rundtur.
BookingType Resor String Bokningstypen.
Weburl Resor String Url:en där resan bokades.
IssueDateTime Resor DateTimeOffset Datum och tid då biljetterna utfärdades.
FlightDetails Resor Objekt Se avsnittet FlightDetails.
LodgingDetails Resor Objekt Se avsnittet LodgingDetails.
CarRentalDetails Resor Objekt Se avsnittet CarRentalDetails.
TravelAgent Resor Objekt Se avsnittet TravelAgent.
FlightDetails
TicketNumber Resor String Det unika biljettnumret.
PlaceOfIssue Resor String Platsen där biljetten utfärdades.
IsRestrictedTicket Resor Booleskt Ett True/False-värde som anger om biljetten är begränsad.
RewardsOrVoucherApplied Resor Booleskt Ett Sant/Falskt-värde som anger om belöningar eller kuponger har tillämpats på ordern.
TotalRewardsApplied Resor int32 De totala belöningar som tillämpades på ordern.
TotalFees Resor decimal De totala avgifter som tillämpas på beställningen.
PassengerCount Resor Int32 Det totala antalet passagerare.
NumberOfStops Resor Int32 Antalet stopp eller layovers för flygningen.
PurchaserProfileType Resor String Kundens profil eller medlemskapstyp.
IsThirdParty Resor Booleskt Ett sant/falskt-värde som anger om ordern har gjorts via en webbplats från tredje part.
IsPurchaserFrequentFlyer Resor Booleskt Ett sant/falskt-värde som anger om kunden är ett frekvent flygblad.
FlightSegments Resor Objekt Se avsnittet FlightSegments.
Passagerare Resor Objekt Se avsnittet Passagerare.
FlightSegments
AirlineCode Resor String Flygkoden.
AirlineName Resor String Namnet på flygbolaget.
SegmentSequence Resor Int32 Sekvensnumret för det angivna flygbenet (t.ex. 2 för den andra delen av flygningen)
TravelClass Resor String Sittklassen eller kabinen.
OperatedBy Resor String Organisationen som kör flygningen.
FlightNumber Resor String Flygnumret.
FromAirportCode Resor String Flygplatskoden där flyget flyger från.
ToAirportCode Resor String Flygplatskoden där flyget flyger till.
DepartureDateTime Resor DateTimeOffset Avgångsdatum och tid.
ArrivalDateTime Resor DateTimeOffset Ankomstdatum och tid.
FromAirportCity Resor String Den flygplatsstad där kunden reser från.
FromAirportState Resor String Flygplatstillståndet där kunden reser från.
FromAirportZipcode Resor String Postnumret till flygplatsen som kunden reser från.
FromAirportCountryISO Resor String Iso-landskoden för flygplatsen som kunden reser från.
ToAirportCity Resor String Den flygplatsstad där kunden reser till.
ToAirportState Resor String Flygplatstillståndet där kunden reser till.
ToAirportZipcode Resor String Postnumret till flygplatsen som kunden reser till.
ToAirportCountryISO Resor String Flygplatsens ISO-land där kunden reser till.
Passagerare
FirstName Resor String Passagerarens förnamn.
LastName Resor String Passagerarens efternamn.
CarRentalDetails
PickupLocation Resor String Upphämtningsplats för biluthyrning.
PickupDateTime Resor DateTimeOffset Datum och tid för upphämtning av biluthyrning.
DropOffLocation Resor String Avlämningsplats för biluthyrning.
DropOffDateTime Resor DateTimeOffset Datum och tid för avlämning av biluthyrning
DiscountProgram Resor String Rabattprogrammet gäller för biluthyrningsbeställningen.
CarType Resor String Biltyp eller kategori.
IsPrepaid Resor Booleskt Ett sant/falskt värde som anger om biluthyrningen var förbetalt.
FörsäkringInkluderad Resor Booleskt Ett sant/falskt värde som anger om försäkringen ingick.
ContactEmail Resor String Biluthyrarens e-postadress.
Kontakt Telefon Nummer Resor String Biluthyrarens telefonnummer.
PickupAddress Resor Objekt Se avsnittet Adress.
DropOffAddress Resor Objekt Se avsnittet Adress.
TravelAgent
AgencyCode Resor String Resebyråkoden.
AgencyName Resor String Resebyråns namn.
AgentCode Resor String Resebyråkoden.
AgencyLocation Resor Objekt Se avsnittet AgentAddress.
AgentAddress
Gata 1 Resor String Den första raden som angavs för adressen
Gata 2 Resor String Den andra raden som angavs för adressen. (Det här värdet kan vara tomt.)
Gata 3 Resor String Den tredje raden som angavs för adressen. (Det här värdet kan vara tomt.)
Ort Resor String Den stad som angavs för adressen.
Tillstånd Resor String Den delstat eller provins som angavs för adressen.
Distrikt Resor String Distriktet som angavs för adressen.
ZipCode Resor String Postnumret som angavs för adressen.
Land Resor String Lands-/regionkoden som angavs för adressen. Värdet ska vara en iso-lands-/regionkod med två bokstäver (till exempel USA).
AgencyContact Telefon Resor String Byrån kontaktar telefonnummer.
AgencyContactEmail Resor String Byrån kontaktar e-postadressen.
LodgingDetails
FolioNumber Logi String Den unika identifieraren för boendeegenskapen.
CheckInDate Logi DateTimeOffset Incheckningsdatum för logivistelsen.
CheckOutDate Logi DateTimeOffset Utcheckningsdatum för logivistelsen.
ReservationConfirmed Logi Booleskt Ett sant/falskt-värde som anger om reservationen har bekräftats.
MembershipDetails Logi String Ytterligare information om kundens medlemskapsstatus.
DiscountProgram Logi String Rabattprogrammet tillämpades på logibeställningen.
AdultCount Logi Int32 Antalet vuxna som ingår i vistelsen.
KidCount Logi Int32 Antalet barn som ingår i vistelsen.
NightsCount Logi Int32 Antalet nätter som ingår i vistelsen.
RoomCount Logi Int32 Antalet rum som ingår i vistelsen.
BedType Logi String Sängtyp eller kategori.
Rumstypen Logi String Rumstyp eller kategori.
PaymentDescription Logi String Ytterligare information om inkvarteringsbetalningen.
Tillgång Logi Objekt Se avsnittet Anläggning.
Tillgång
Name Logi String Anläggningens namn.
Typ Logi String Anläggningstypen.
Kontakt Telefon Nummer Logi String Telefonnumret som användes för att kontakta anläggningen.
ContactEmail Logi String E-postadressen som användes för att kontakta anläggningen.
DailyRoomRate Logi decimal Den dagliga rumspriset för anläggningen.
Valuta Logi String Den valuta som stöds av faciliteten.
DailyRoomTaxAmount Logi decimal Det dagliga rumsskattebeloppet som debiteras av anläggningen.
Adress Logi Objekt Se avsnittet Adress.
Address
Gata 1 Biluthyrning String Den första raden som angavs för adressen
Gata 2 Biluthyrning String Den andra raden som angavs för adressen. (Det här värdet kan vara tomt.)
Gata 3 Biluthyrning String Den tredje raden som angavs för adressen. (Det här värdet kan vara tomt.)
Ort Biluthyrning String Den stad som angavs för adressen.
Tillstånd Biluthyrning String Den delstat eller provins som angavs för adressen.
Distrikt Biluthyrning String Distriktet som angavs för adressen.
ZipCode Biluthyrning String Postnumret som angavs för adressen.
Land Biluthyrning String Lands-/regionkoden som angavs för adressen. Värdet ska vara en iso-lands-/regionkod med två bokstäver (till exempel USA).
CloudBusiness
OrganizationId CloudBusiness String Den unika identifieraren för molntjänsten eller organisationen.
CompanyName CloudBusiness String Namnet på molntjänsten.
CompanyType CloudBusiness String Molnföretagstypen.
CompanySize CloudBusiness Int32 Molnföretagets storlek.
EntityId CloudBusiness String Den unika identifieraren för den juridiska personen under organisationen.
PrimaryContactFirstName CloudBusiness String Förnamnet på den primära kontakten för företaget.
PrimaryContactLastName CloudBusiness String Efternamnet på den primära kontakten för företaget.
PrimaryContactEmail CloudBusiness String E-postadressen till den primära kontakten för företaget.
PrimaryContact Telefon Number CloudBusiness String Telefonnumret för den primära kontakten för företaget.
SubscriptionCount CloudBusiness Int32 Det totala antalet tillgängliga prenumerationer.
CompanyAddress CloudBusiness Objekt Se avsnittet Adress.

Ladda ned exempeldata

Du kan ladda ned våra exempeldatafiler för att utforska alternativ innan du använder dina egna interna data.

  • För exempel som du kan använda med förlustskydd väljer du Exempeldatafil för förlustskydd.
  • För exempel som du kan använda med köpskydd väljer du Exempeldatafil för köpskydd.

Exempel på anpassade data

Följande exempel visar hur du använder köp-API:er med ett anpassat dataobjekt i Bedrägeriskydd.

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