# Vásárló ellenőrzése

> A POST /check rendelés előtt javaslatot (engedélyez, jelez, tilt), szintet, pontszámot és okokat ad egy vásárlóra, hash-elt azonosítókból.

```http
POST /check
```

A rendelés leadása előtt hívd, a vásárló azonosítóinak hash-ével ([hash-elés](https://docs.uptools.io/hu/trustorder/api/hashing/)). Csak az `email_hash` kötelező; minden hash-t küldj el, ami megvan.

```json
{
  "email_hash": "8cd79ce2224abde026ddc67563fe5edb8b5eb41846c63cd550a76ea76cc2eddd",
  "phone_hash": "038e5821814169825ae568bfefdb18ca31d4d2e0a0f5941b6da27df45d50ddf4",
  "address_hash": "956b4ad633a194c484c3fdd6d6145ec1ac929b211438b3452e79b4853f65df96",
  "email_domain_hashes": ["4672a2431309380c7954c449b3ff20d2cd31968853d6e98137dd3b0be3652dae"],
  "email_domain_mx": true,
  "strictness": "normal"
}
```

| Mező | Típus | |
|---|---|---|
| `email_hash` | hash | kötelező |
| `phone_hash` | hash vagy `null` | |
| `address_hash` | hash vagy `null` | szállítási cím |
| `email_domain_hashes` | hash-ek tömbje, legfeljebb 5 | a domain és a szülő-szuffixei |
| `email_domain_mx` | `true`, `false` vagy `null` | a saját MX-ellenőrzésed |
| `strictness` | `lenient`, `normal` (alap), `strict` | mi legyen a kockázatos vásárlóval |

Az ismeretlen mezőt `400`-zal elutasítja. A teszt kulcs csak a teszt visszajelzéseket látja.

## Válasz

```json
{
  "verdict": "block",
  "level": "blocked",
  "score": 33,
  "reasons": ["NEGATIVE_MULTI_ACCOUNT", "NEGATIVE_RECENT", "LOW_SCORE"],
  "stats": { "delivered": 0, "refused": 2, "accounts_refused": 2 },
  "check_id": "01a1a17c-7e54-7032-95b4-ba478164249b"
}
```

| Mező | Jelentés |
|---|---|
| `verdict` | mit tegyél: `allow` (engedélyez), `flag` (jelez) vagy `block` (tilt) |
| `level` | `trusted`, `unknown`, `risky` vagy `blocked` |
| `score` | 0 és 100 között; előzmény nélkül 75 |
| `reasons` | a lenti kódok, rögzített sorrendben |
| `stats` | átvételek, visszautasítások és a visszautasítást jelző fiókok száma, a legrosszabb azonosítóra, három évre |
| `check_id` | azonosító ügyfélszolgálati kérdéshez; az `X-Check-Id` fejlécben is |

## Szint

Minden azonosítót (e-mail, telefon, cím) külön pontoz, és a legrosszabb számít. Egy új e-mail-cím nem moshatja tisztára a visszautasításokkal terhelt telefonszámot.

| Szint | Mikor |
|---|---|
| `blocked` | legalább két fióktól friss visszautasítás, és 60 alatti pontszám |
| `risky` | visszautasítás az elmúlt 365 napban, vagy 60 alatti pontszám, vagy eldobható, illetve levelet nem fogadó e-mail domain |
| `trusted` | legalább három átvétel, friss visszautasítás nélkül |
| `unknown` | minden más, például ha nincs előzmény |

A visszautasítás 365 napig számít frissnek. A cím fele akkora súllyal számít, mint az e-mail és a telefon, mert sokan osztoznak rajta (társasház, csomagpont).

## Javaslat

A szintből és a kérés `strictness` értékéből jön a javaslat:

| Szigorúság | `blocked` | `risky` | `unknown`, `trusted` |
|---|---|---|---|
| `lenient` | `block` | `allow` | `allow` |
| `normal` | `block` | `flag` | `allow` |
| `strict` | `block` | `block` | `allow` |

A bolti kivétel felülírja: az `allow` mindig `allow`, a `deny` mindig `block` ([kivételek](https://docs.uptools.io/hu/trustorder/api/other/#kivételek)). A szint és a pontszám ilyenkor is kiszámolódik.

## Okok

| Kód | Jelentés |
|---|---|
| `NEGATIVE_MULTI_ACCOUNT` | több fióknál is visszautasította: ez tette `blocked`-dá |
| `NEGATIVE_RECENT` | visszautasítás az elmúlt 365 napban |
| `LOW_SCORE` | a pontszám 60 alatt van |
| `DISPOSABLE_DOMAIN` | az e-mail domainje eldobható e-mail-szolgáltatásé |
| `DOMAIN_NO_MX` | az e-mail domainje nem fogad levelet (az `email_domain_mx` értéked `false` volt) |
| `NO_HISTORY` | egyik azonosítóhoz sincs még visszajelzés |
| `SHOP_ALLOW` | a kivételed átengedi ezt a vásárlót |
| `SHOP_DENY` | a kivételed tiltja ezt a vásárlót |

## Mit kezdj a javaslattal

A javaslat csak javaslat, a bolt dönt. Például: `block` esetén elrejted az utánvétet, és előre fizetést kínálsz; `flag` esetén jelzed a bolti csapatnak; `allow` esetén nem változtatsz semmin. A vásárlót soha ne hagyd fizetési mód nélkül.
