Zum Inhalt springen
LOX24 API Docs

Frau Detectinon Abfrage

POST
/fraud-checks

Erstellt eine Anfrage an die Fraud Detection API um den Risikofaktor für einen Betrug zu bestimmen.

Authorizations

Abschnitt betitelt „Authorizations “

Request Body required

Abschnitt betitelt „Request Body required “

The new fraud-check resource

Media type application/json

Fraud check request

object
service_code
required

Der Servicecode bestimmt die Art der Betrugsabfrage, die Sie durchführen. economy enthält nur einen Risikowert, während pro und direct mehr Details zu den Ergebnissen enthalten, so dass Sie Ihre eigene Entscheidung treffen können. direct Abfragen werden ebenfalls mit Priorität bearbeitet. (siehe /me)

string
Allowed values: economy pro direct
callback_data
Any of:

Wert (String) welcher an Ihren Endpoint zurückgeschickt wird. Sie können z.B. Ihre eigene ID so übergeben und mit dem Zustellbericht (DLR) zurückbekommen.

string | null
<= 36 characters
phone
Any of:

Zielrufnummer:

  • +491701234567 (E.164)
  • 00491701234567
  • 491701234567
  • 01701234567 (wenn Ihr Account in Deutschland registriert ist) wird es konvertiert zu +491701234567

Wenn Sie Ihre Rufnummer nicht im E.164 Format übertragen, versucht unser System die Rufnummer anhand Ihres Firmensitzes aus Ihren Profildaten in E.164 Format zu konvertieren. Um Probleme bei der automatischen Konvertierung zu vermeiden, nutzen Sie bitte bevorzugt das E.164 Format.

string
>= 7 characters <= 16 characters /^\+[1-9]\d{1,14}$/
Example 
+14155552671
email
Any of:

E-Mail Adresse

string
>= 6 characters <= 500 characters
ip
Any of:

IP-Adresse (IP v4/v6)

string
>= 7 characters <= 39 characters
address
Any of:

Fraud check request address

object
iso2
required

Ländercode

string
>= 2 characters <= 2 characters /^[A-Z]{2}$/
city
required

Name der Stadt

string | null
>= 2 characters <= 100 characters
postcode

Postleitzahl

string | null
>= 3 characters <= 20 characters
street_number

Hausnummer

string | null
>= 1 characters <= 30 characters
street_name
required

Straßename

string | null
>= 2 characters <= 255 characters

Responses

Abschnitt betitelt „ Responses “

201

Abschnitt betitelt „201 “

Fraud-check resource created

Fraud check request

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
id

Eindeutige Entitäts-UUID

string
/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/
status_code

Statuscodes der Anfrageverarbeitung:

  • 0 – neue Anfrage und noch nicht bearbeitet
  • 5 – Anfrage in Bearbeitung
  • 10 – Verarbeitung der Abfrage erfolgreich abgeschlossen
  • 20 - Verarbeitung mit Fehler abgeschlossen: nicht genug Guthaben/Kreditlinie
  • 21 - Verarbeitung mit Fehler abgeschlossen: ungültige Daten
  • 1000 - Verarbeitung mit Fehler abgeschlossen: unerwarteter Fehler
integer
Allowed values: 0 5 10 20 21 1000
risk_score

Betrugsrisiko-Score von 0 (gut) bis 100 (schlecht)

number
<= 100
service_code
required

Der Servicecode bestimmt die Art der Betrugsabfrage, die Sie durchführen. economy enthält nur einen Risikowert, während pro und direct mehr Details zu den Ergebnissen enthalten, so dass Sie Ihre eigene Entscheidung treffen können. direct Abfragen werden ebenfalls mit Priorität bearbeitet. (siehe /me)

string
Allowed values: economy pro direct
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
callback_data
Any of:

Wert (String) welcher an Ihren Endpoint zurückgeschickt wird. Sie können z.B. Ihre eigene ID so übergeben und mit dem Zustellbericht (DLR) zurückbekommen.

string | null
<= 36 characters
request_phone
Any of:

Fraud check request phone number

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
status_code

Statuscodes der Anfrageverarbeitung:

  • 0 – neue Anfrage und noch nicht bearbeitet
  • 5 – Anfrage in Bearbeitung
  • 10 – Verarbeitung der Abfrage erfolgreich abgeschlossen
  • 20 - Verarbeitung mit Fehler abgeschlossen: nicht genug Guthaben/Kreditlinie
  • 21 - Verarbeitung mit Fehler abgeschlossen: ungültige Daten
  • 1000 - Verarbeitung mit Fehler abgeschlossen: unerwarteter Fehler
integer
Allowed values: 0 5 10 20 21 1000
phone
required

Zielrufnummer:

  • +491701234567 (E.164)
  • 00491701234567
  • 491701234567
  • 01701234567 (wenn Ihr Account in Deutschland registriert ist) wird es konvertiert zu +491701234567

Wenn Sie Ihre Rufnummer nicht im E.164 Format übertragen, versucht unser System die Rufnummer anhand Ihres Firmensitzes aus Ihren Profildaten in E.164 Format zu konvertieren. Um Probleme bei der automatischen Konvertierung zu vermeiden, nutzen Sie bitte bevorzugt das E.164 Format.

string
>= 7 characters <= 16 characters /^\+[1-9]\d{1,14}$/
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
is_possible

Telefonnummer theoretisch möglich

boolean
is_valid

Telefonnummer gültig

boolean
region

Ländercode

string
>= 2 characters <= 2 characters /^[A-Z]{2}$/
number_type

Rufnummerntyp

string
request_email
Any of:

Fraud check request email

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
status_code

Statuscodes der Anfrageverarbeitung:

  • 0 – neue Anfrage und noch nicht bearbeitet
  • 5 – Anfrage in Bearbeitung
  • 10 – Verarbeitung der Abfrage erfolgreich abgeschlossen
  • 20 - Verarbeitung mit Fehler abgeschlossen: nicht genug Guthaben/Kreditlinie
  • 21 - Verarbeitung mit Fehler abgeschlossen: ungültige Daten
  • 1000 - Verarbeitung mit Fehler abgeschlossen: unerwarteter Fehler
integer
Allowed values: 0 5 10 20 21 1000
email
required

E-Mail Adresse

More information

string format: email
>= 6 characters <= 500 characters
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
is_possible

E-Mail möglich

boolean
is_anonymous

Wird der Dienst zur Anonymisierung des Absenders der E-Mail verwendet

boolean
request_ip
Any of:

Fraud check request IP address

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
status_code

Statuscodes der Anfrageverarbeitung:

  • 0 – neue Anfrage und noch nicht bearbeitet
  • 5 – Anfrage in Bearbeitung
  • 10 – Verarbeitung der Abfrage erfolgreich abgeschlossen
  • 20 - Verarbeitung mit Fehler abgeschlossen: nicht genug Guthaben/Kreditlinie
  • 21 - Verarbeitung mit Fehler abgeschlossen: ungültige Daten
  • 1000 - Verarbeitung mit Fehler abgeschlossen: unerwarteter Fehler
integer
Allowed values: 0 5 10 20 21 1000
ip
required

IP-Adresse (IP v4/v6)

string
>= 7 characters <= 39 characters
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
iso2

Ländercode

string
>= 2 characters <= 2 characters /^[A-Z]{2}$/
state

Bundesland oder Region der IP-Adresse

string
city

Stadt der IP-Adresse

string
postcode

PLZ der IP-Adresse

string
geolocation

Der Breitengrad und Längengrad der IP-Adresse (array)

Array<number>
isp_name

Der Name des des Internet Service Providers (ISP)

string
isp_risk_score

Risikofaktor für ISP

number
<= 100
proxy_type

Wenn der Host ein Proxy ist:

  • VPN – Anonymisierende VPN-Dienste. Diese Dienste bieten Nutzern ein öffentlich zugängliches VPN an, um ihre IP-Adresse zu verbergen.
  • TOR – Tor-Ausgangsknoten. Das Tor-Projekt ist ein offenes Netzwerk, das von denjenigen genutzt wird, die Anonymität wahren wollen.
  • DCH – Hosting-Anbieter, Datenzentrum oder Content Delivery Network. Da Hosting-Provider und Datenzentren dazu dienen können, Anonymität zu gewährleisten, kennzeichnet die Anonymous-IP-Datenbank IP-Adressen, die mit ihnen in Verbindung stehen.
  • PUB – Öffentliche Proxies. Dies sind Dienste, die Verbindungsanfragen im Namen eines Nutzers stellen. Die Proxy-Server-Software kann vom Administrator so konfiguriert werden, dass sie auf einem bestimmten Port lauscht. Sie unterscheiden sich von VPNs dadurch, dass die Proxys im Vergleich zu VPNs in der Regel eingeschränkte Funktionen haben.
  • WEB – Web-Proxys. Hierbei handelt es sich um Webdienste, die Webanfragen im Namen eines Benutzers stellen. Sie unterscheiden sich von VPNs oder öffentlichen Proxys dadurch, dass sie einfache webbasierte Proxys sind und nicht auf der Ebene der IP-Adresse und anderer Ports arbeiten.
  • SES – Suchmaschinen-Roboter. Dies sind Dienste, die eine Website crawlen oder scrapen, wie z. B. die Suchmaschinenspider oder -bots.
string
Allowed values: VPN TOR DCH PUB WEB SES
connection_type

Internet Einwahltyp kann sein: “dialup”, “isdn”, “cable”, “dsl”, “fttx”, “wireless” oder null

string | null
Allowed values: dialup isdn cable dsl fttx wireless
is_ok

Was the request handled correctly?

boolean
request_address
Any of:

Fraud check request address

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
status_code

Statuscode der Anfrage

integer | null
iso2
required

Ländercode

string
>= 2 characters <= 2 characters /^[A-Z]{2}$/
city
required

Name der Stadt

string | null
>= 2 characters <= 100 characters
postcode

Postleitzahl

string | null
>= 3 characters <= 20 characters
street_number

Hausnummer

string | null
>= 1 characters <= 30 characters
street_name
required

Straßename

string | null
>= 2 characters <= 255 characters
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
price

Preis

number
Example 
{
  "@context": {
    "hydra": "http://www.w3.org/ns/hydra/core#"
  },
  "status_code": 0,
  "service_code": "economy",
  "request_phone": {
    "@context": {
      "hydra": "http://www.w3.org/ns/hydra/core#"
    },
    "status_code": 0,
    "phone": "+14155552671",
    "region": "US"
  },
  "request_email": {
    "@context": {
      "hydra": "http://www.w3.org/ns/hydra/core#"
    },
    "status_code": 0
  },
  "request_ip": {
    "@context": {
      "hydra": "http://www.w3.org/ns/hydra/core#"
    },
    "status_code": 0,
    "iso2": "US",
    "proxy_type": "VPN",
    "connection_type": "dialup"
  },
  "request_address": {
    "@context": {
      "hydra": "http://www.w3.org/ns/hydra/core#"
    },
    "iso2": "US"
  }
}

400

Abschnitt betitelt „400 “

Ungültige Eingabe

401

Abschnitt betitelt „401 “

Kunden-Nr oder API Key sind ungültig oder inaktiv!

402

Abschnitt betitelt „402 “

There are not enough funds on your account!

403

Abschnitt betitelt „403 “

Account ist noch nicht innerhalb von 24h nach Registrierung aktiviert. Bitte warten oder Support kontaktieren

422

Abschnitt betitelt „422 “

Die Anfrage war korrekt formatiert, konnte aber aufgrund semantischer Fehler nicht verarbeitet werden

429

Abschnitt betitelt „429 “

Die IP-Adresse wurde vorübergehend blockiert, da in kurzer Zeit viele Anfragen mit ungültigen Anmeldeinformationen gesendet wurden. Bitte warten Sie und versuchen Sie es später.

Code Samples

 
#!/usr/bin/env bash
curl -X POST https://api.lox24.eu/fraud-checks \
  -H 'Content-Type: application/json' \
  -H 'X-LOX24-AUTH-TOKEN: 1234567:e3f3a759b6677959b6ebfcxxxxxxxxxx' \
  -d '{
          "service_code": "direct",
          "phone": "+49751234567",
          "email": "test@lox24.de",
          "ip": "1.1.1.1",
          "address": {
                "iso2": "DE",
                "city": "Berlin",
                "postcode": "13353",
                "street_number": "109",
                "street_name": "Seestraße"
          }


}'