Labels-API

Artikel
04/10/2024

In dit artikel wordt uitgelegd hoe u met de labels-API gegevens kunt verzenden naar de virtuele fraudeanalyse en controledashboards in Microsoft Dynamics 365 Fraud Protection.

Met de labels-API kunt u fraude- of non-fraudesignalen naar Fraud Protection verzenden. Deze gegevens worden gebruikt voor modeltraining, de beoordeling van modelprestaties en rapportage. De labels-API is een algemene API waarmee beoordelingsgebeurtenissen worden gelabeld met afzonderlijke transactie- of gebeurtenis-id's of -entiteiten, zoals een gebruiker of betaalmiddel.

Veelvoorkomende labelscenario's voor transacties of gebeurtenissen

Alle frauduleuze transacties die door uw klanten zijn geëscaleerd
Frauduleuze activiteit of accountmisbruik geïdentificeerd door uw beoordelingsteam
Offline analyses (zoals gedragsanalyse of ontdekte verbindingen met bestaande fraudegevallen)
TC40/SAFE-signalen die worden ontvangen
Het terugdraaien van een eerder fraude signaal nadat is geïdentificeerd als niet-fraude op basis van de meest recente informatie
Ontvangen terugstortingen/terugbetalingen
Terugboeking van toerekening na een geschil

We raden u aan de API voor terugstorting en terugbetaling te gebruiken om informatie met betrekking tot terugstortingen en terugbetalingen te verstrekken. Zie Dynamics 365 Fraud Protection-service voor meer informatie over ondersteunde gebeurtenissen.

Details van accounts of betaalmiddelen

Frauduleuze account of informatie over betaalmiddelen die zijn geïdentificeerd door uw beoordelingsteam
Scenario's voor accountovername geëscaleerd door uw klanten

API-schema

Kenmerk	Type	Description
labelObjectType	Vaste tekst Verwachte waarden: PURCHASE, ACCOUNTCREATION, ACCOUNTLOGIN, ACCOUNT, PI, EMAIL	Dit kenmerk geeft aan hoe uitgebreid u een label wilt markeren. U kunt bijvoorbeeld één transactie of alle transacties van een gebruikersrekening als frauduleus markeren. Afhankelijk van het objecttype worden gerelateerde transacties of gebeurtenissen in Fraud Protection als frauduleus of niet-frauduleus gemarkeerd. Als de waarde van labelObjectType bijvoorbeeld PURCHASE, ACCOUNTCREATION of ACCOUNTLOGIN is, worden specifieke transacties gelabeld in Fraud Protection. Als de waarde ACCOUNT of PI is, worden alle transacties gerelateerd aan de gebruikersrekening of het betaalmiddel door Fraud Protection gemarkeerd.
labelObjectId	Tekenreeks	De id die overeenkomt met de waarde van het kenmerk labelObjectType. Fraud Protection gebruikt deze waarde om gerelateerde transacties en gebeurtenissen te vinden. De id's van de labelobjecttypen zijn de volgende: PURCHASE: purchaseId ACCOUNTCREATION: signupId ACCOUNTLOGIN: loginId ACCOUNT: userId PI: merchantPaymentInstrumentId Dit kenmerk is zeer belangrijk omdat het in Fraud Protection wordt gebruikt om de oorspronkelijke beoordelingsgebeurtenis te identificeren. Daarom moet de waarde overeenkomen met de oorspronkelijke transactie- of gebeurtenis-id.
labelSource	Tekenreeks	De bron van labelinformatie. Sommige voorgestelde waarden zijn ManualReview, als een fraudelabel wordt geïdentificeerd door het beoordelingsteam, en CustomerEscalation als een klant met een onterecht afgewezen (fout-positieve) transactie werkt. TC40/SAFE-gegevens zijn een andere bron voor labelgegevens.
isFraud	Booleaans	Dit kenmerk geeft aan of het label frauduleus of niet-frauduleus is. Als er geen waarde wordt opgegeven, wordt in Fraud Protection true gebruikt als standaardwaarde.
reasonText	Tekenreeks	De reden voor het labelen van iets als frauduleus of niet-frauduleus. U kunt redenen negeren als u beperkte informatie hebt over uw labelbronnen. Afhankelijk van uw labelwerkstromen kunt u sommige scenario's ook aan enkele van deze waarden toewijzen.
labelReasonCodes	Tekenreeks	Genormaliseerde redencodes of redencodes die worden ontvangen van de betalingsverwerker. U kunt dit kenmerk negeren als u geen redendetails hebt. Sommige voorgestelde waarden zijn Processorresponscode, Bankresponscode, Frauderestitutie, Accountovername, Fraude met betaalmiddel, Accountfraude, Misbruik, Vriendelijke fraude, Gelekte accountgegevens en Geslaagde accountbeveiligingscontroles.
labelState	Tekenreeks	Het type label dat u verstuurt. Dit kenmerk wordt vooral gebruikt als u een eerder fraudesignaal of een fout-positief signaal hebt omgekeerd. In beide gevallen stelt u isFraud in op false. De status kan echter helpen bij het identificeren van fout-positieve labels.
Processor	Tekenreeks	De naam van de betalingsverwerker.
eventTimeStamp	DateTime (ISO 8601-indeling)	De met het label aangeduide tijdstempel. Als de API rechtstreeks is geïntegreerd met het labelopsporingsproces en u de label-API aanroept zodra een controlemedewerker een transactie markeert als fraude, kan de waarde de huidige tijdstempel zijn. Deze waarde is vooral belangrijk voor het bepalen van de volgorde van gebeurtenissen als er meerdere labels zijn. Als een transactie voor het maken van een inkoop of rekening bijvoorbeeld wordt aangeduid als fraude, maar later wordt aangeduid als niet-fraude, verwijst Fraud Protection naar deze waarde om te bepalen welke van de twee labels recenter is en dus correct is.
effectiveStartDate	DateTime (ISO 8601-indeling)	De effectieve begin- en einddatums zijn bedoeld voor labels die breder zijn dan één transactie (en voor labelObjectType doorgaans een waarde van ACCOUNT hebben) om het effect van die labels te beperken tot een bepaalde periode. In scenario's waar accounts worden gehackt bepalen deze datums de periode waarin de transacties of gebeurtenissen moeten worden gelabeld.
effectiveEndDate	DateTime-indeling (ISO 8601)	De effectieve begin- en einddatums zijn bedoeld voor labels die breder zijn dan één transactie (en voor labelObjectType doorgaans een waarde van ACCOUNT hebben) om het effect van dat label te beperken tot een bepaalde periode. In scenario's waar accounts worden gehackt bepalen deze datums de periode waarin de transacties of gebeurtenissen moeten worden gelabeld.
Bedrag	Dubbel	Het totale fraudebedrag. U kunt deze waarde overslaan als er geen bedrag beschikbaar is. In scenario's voor het maken van en aanmelden bij een rekening is er bijvoorbeeld mogelijk geen gekoppeld bedrag. In het inkoopscenario wordt in Fraud Protection het transactiebedrag gebruikt.
Valuta	Tekenreeks	De uit drie tekens bestaande ISO-valutacode (International Organization for Standardization) die gerelateerd is aan het bedrag.

Voorbeelden van API-nettoladingen voor veelvoorkomende scenario's

Scenario 1

Uw beoordelingsteam heeft tijdens het bekijken van de betalingsgegevens verdachte transacties geïdentificeerd.

{
    "labelObjectType": "PURCHASE",
    "labelObjectId": "<purchase transaction Id, i.e., purchaseId>",
    "labelSource": "ManualReview",
    "isFraud": true,
    "labelState": "Fraud",
    "eventTimeStamp": "2022-10-04T16:24:36.045Z",
    "_metadata": {
        "trackingId": "<guid or identifier>",
        "merchantTimeStamp": "2022-10-04T20:44:14.706Z"
    }
}

Scenario 2

Een gebruiker heeft de toegang tot een account verloren en een kwaadwillende gebruiker heeft de referenties van die gebruiker gebruikt om zich aan te melden. Later heeft de gebruiker zijn referenties hersteld en een tijdsinterval gerapporteerd dat de account is gehackt.

{
    "labelObjectType": "ACCOUNT",
    "labelObjectId": "<userId>",
    "labelSource": "CustomerEscalation",
    "isFraud": true,
    "reasonText": "AccountCompromise",
    "labelState": "Fraud",
    "eventTimeStamp": "2022-10-04T12:21:46.326Z",
    "effectiveStartDate": "2022-10-03T10:00:00.000Z",
    "effectiveEndDate": "2022-10-04T12:16:00.000Z",
    "_metadata": {
        "trackingId": "<guid or identifier>",
        "merchantTimeStamp": "2022-10-04T12:21:46.326Z"
    }
}

Scenario 3

U hebt een verdachte gebruikersaanmelding geblokkeerd en later heeft de gebruiker het ondersteuningsteam gebeld om de blokkering op te heffen. Als het ondersteuningsteam het bewijs controleert, bevestigt dat de gebruiker de legitieme gebruiker is en de gebruiker deblokkeert, moet u een label met de status FalsePositive verzenden.

{
    "labelObjectType": "ACCOUNT",
    "labelObjectId": "<userId>",
    "labelSource": "CustomerEscalation",
    "isFraud": false,
    "reasonText": "AccountCompromise",
    "labelState": "FalsePositive",
    "eventTimeStamp": "2022-10-04T16:21:46.326Z",
    "_metadata": {
        "trackingId": "<guid or identifier>",
        "merchantTimeStamp": "2022-10-04T16:21:46.326Z"
    }
}

Share via