# Visszajelzések

> Jelezd vissza, átvette vagy visszautasította-e a vásárló az utánvétes rendelést (PUT /signals/{order_ref}), vond vissza (DELETE), vagy küldj egyszerre 500-at.

A TrustOrder a csatlakozó boltok visszajelzéseiből dolgozik. Minden rendelést jelezz vissza, amint kiderült a kimenetele: `delivered`, ha a vásárló átvette, `refused`, ha nem.

## Egy rendelés

```http
PUT /signals/{order_ref}
```

Az `order_ref` a saját rendelés-azonosítód, 1-128 karakter vezérlőkarakterek nélkül, az útvonalban URL-kódolva (a `/` `%2F`-ként).

```json
{
  "outcome": "refused",
  "email_hash": "8cd79ce2224abde026ddc67563fe5edb8b5eb41846c63cd550a76ea76cc2eddd",
  "phone_hash": "038e5821814169825ae568bfefdb18ca31d4d2e0a0f5941b6da27df45d50ddf4",
  "address_hash": null,
  "occurred_at": "2026-11-01T14:03:00Z"
}
```

| Mező | |
|---|---|
| `outcome` | `delivered` vagy `refused`, kötelező |
| `email_hash`, `phone_hash`, `address_hash` | legalább egy kötelező |
| `occurred_at` | RFC 3339; alapból a mostani idő; legfeljebb 5 perccel a jövőben és legfeljebb 1095 napos |

A hívás idempotens: ugyanaz az `order_ref` újra küldve egy visszajelzés marad, az utolsó számít. A válasz megmondja, mi történt:

| `result` | Jelentés |
|---|---|
| `stored` | elmentve vagy módosítva |
| `unchanged` | ugyanez a visszajelzés már megvolt |
| `voided` | a visszajelzést vitatás után érvénytelenítették; már nem számít, és nem módosítható |

## Visszavonás

```http
DELETE /signals/{order_ref}
```

Akkor használd, ha a rendelés visszakerül, például teljesítettből feldolgozás alattiba. A válasz `204`; `404`, ha nincs ilyen visszajelzés, és `409` érvénytelenítettnél.

## Sok rendelés egyszerre

```http
POST /signals/batch
```

```json
{
  "signals": [
    { "order_ref": "1001", "outcome": "delivered", "email_hash": "8cd79ce2…" },
    { "order_ref": "1002", "outcome": "refused", "email_hash": "8cd79ce2…" }
  ]
}
```

1-500 sor, mindegyik a fenti mezőkkel és az `order_ref`-fel; a kérés legfeljebb 1 MiB. Minden sort külön kezel, és a válasz a küldés sorrendjében sorolja fel őket:

```json
{
  "results": [
    { "order_ref": "1001", "result": "stored" },
    { "order_ref": "1002", "error_code": "INVALID_REQUEST" }
  ]
}
```

Az érvénytelen sor `INVALID_REQUEST`-et kap, és nem állítja meg a többit. Az `INTERNAL` sor nem mentődött el; küldd el újra a batch-et, biztonságosan ismételhető. Induláskor ezzel töltheted be a korábbi rendeléseket: az 1095 napnál nem régebbi visszajelzések számítanak.

## Teszt és éles

A visszajelzés a kulcs környezetébe kerül. A teszt kulccsal küldöttek soha nem hatnak az éles javaslatokra. Az új fiók visszajelzései azonnal tárolódnak, és a jóváhagyástól számítanak.
