# Hibaelhárítás

> Mi történik, ha a szolgáltatás nem érhető el, kapcsolati hibák, PHP intl, látogatói IP proxy mögött, ellenőrzési keretek és teszt mód.

## Ha a TrustOrder szolgáltatás nem érhető el

A TrustOrder hiba esetén átengedi a rendelést. Ha a szolgáltatás lassú vagy nem érhető el, semmi nem tűnik el, és minden rendelés átmegy. A pénztár legfeljebb 1,5 másodpercig vár a válaszra.

Bármilyen hiba (időtúllépés, hálózati hiba, váratlan válasz, hiányzó API-kulcs) esetén semmi nem tűnik el, és a rendelés átmegy. A rendelés **Nem ellenőrzött** jelölést kap, így magad is megnézheted.

## Kapcsolati hibák és az utolsó hiba

Az **Áttekintés** oldalon a **Kapcsolat** kártya mutatja a kapcsolattesztet, az **Utolsó hiba** rész pedig a legutóbbi problémát érthetően, a naplózás idejével. Ha még nem volt hiba, ezt látod: „Eddig nem volt hiba.”

| Üzenet | Teendő |
|---|---|
| Az API-kulcsot nem fogadta el a szolgáltatás. Nézd meg, hogy a teljes kulcsot másoltad-e be. | Illeszd be újra a teljes kulcsot. |
| A kulcshoz tartozó fiók vagy bolt fel van függesztve vagy ki van kapcsolva. Írj az upToolsnak. | Írj az upToolsnak. |
| Túl sok kérés rövid idő alatt. A TrustOrder magától újrapróbálja. | Semmi, magától újrapróbálja. |
| Elfogyott a napi ellenőrzési keret. Holnapig minden fizetési mód elérhető marad. | Várj holnapig. |
| A szolgáltatás nem válaszolt időben. A rendelés minden fizetési móddal átment. | Semmi, a rendelés átment. |
| Erről a szerverről nem érhető el a szolgáltatás (hálózati vagy DNS-hiba). | Kérd meg a tárhelyszolgáltatódat, hogy nézze meg a szerver hálózatát és DNS-ét. |
| Átmeneti hiba a szolgáltatás oldalán. | Semmi, próbáld újra később. |
| A szolgáltatás érvénytelennek minősített egy kérést. Ha ismétlődik, frissítsd a bővítményt. | Frissítsd a bővítményt. |
| Nincs elmentett API-kulcs. | Adj meg kulcsot: [Telepítés és bekötés](https://docs.uptools.io/hu/trustorder/wordpress/install/). |
| Egy kockázatos vásárlónak egyetlen fizetési módja sem maradt volna, ezért semmi nem lett elrejtve. Állíts be tartalék fizetési módot. | Válassz tartalék fizetési módot: [Beállítások](https://docs.uptools.io/hu/trustorder/wordpress/settings/). |
| Betelt egy helyi ellenőrzési keret (munkamenetenként vagy látogatói hálózatonként); ezek a vásárlók nem lettek ellenőrizve. | Lásd lent: Ellenőrzési keretek. |

Ha a fiók **Jóváhagyásra vár**, az ellenőrzés már működik; az upTools hamarosan jóváhagyja a fiókot.

## Ékezetes karakterek (PHP intl)

Az **Áttekintés** oldal **Állapot** listája mutatja, hogy az **Ékezetes karakterek (PHP intl)** sor **Elérhető** vagy **Hiányzik**.

Ha hiányzik a PHP `intl` vagy `mbstring` bővítmény, a nem ASCII karaktereket tartalmazó értékekből (ékezetes címek, nemzetközi e-mail-domainek) nem készül kód, és az olyan rendelés, amelynek az e-mail-címében ilyen karakter van, nem kerül ellenőrzésre. Ilyenkor az admin felület figyelmeztet. Kérd meg a tárhelyszolgáltatódat, hogy kapcsolja be az `intl` és az `mbstring` bővítményt.

## Látogatói IP proxy mögött

A TrustOrder látogatói hálózatonként korlátozza az ellenőrzéseket, ezért a valódi látogatói címre van szüksége.

- A látogatói hálózat a `REMOTE_ADDR` értékéből jön.
- Az `X-Forwarded-For` fejlécben soha nem bízik meg.
- Ha a boltod proxy vagy terheléselosztó mögött van, a valódi látogatói címet a `trustorder_client_ip` szűrővel add vissza.
- Ha a látogatói cím privát, szolgáltatói NAT (100.64.0.0/10), loopback, link-local vagy IPv6 ULA cím, ami általában azt jelenti, hogy proxy áll a bolt előtt, a hálózati keretek kimaradnak, amíg be nem állítod a `trustorder_client_ip` szűrőt. A munkamenetenkénti keretek ilyenkor is érvényesek.
- Az IPv4-re leképezett IPv6 címek (`::ffff:a.b.c.d`) IPv4-nek számítanak, az IPv6 címek /64-es csoportokba kerülnek.

## Ellenőrzési keretek

Az API-keret védelmében a TrustOrder korlátozza az ellenőrzések számát:

- Amíg a vásárló gépel, pénztári munkamenetenként legfeljebb 5 ellenőrzés fut.
- A rendelés leadásának külön kerete van: munkamenetenként legfeljebb 3 ellenőrzés.
- Látogatói hálózatonként 30 percenként legfeljebb 20 ellenőrzés gépelés közben és 10 a rendelés leadásakor.
- Az egész boltra óránként legfeljebb 300 ellenőrzés gépelés közben.

A kereteket a `trustorder_ip_check_limit`, a `trustorder_submit_ip_check_limit` és a `trustorder_hourly_check_limit` szűrővel módosíthatod.

Mi történik, ha betelik egy keret:

- Ha a rendelésleadási keret egy még nem ellenőrzött vásárlónál telik be, a kockázatos fizetési módok rejtve maradnak. Az utolsó megmaradó fizetési mód soha nem tűnik el.
- Ha egy rendelésleadáskori ellenőrzés azért hiúsul meg, mert a szolgáltatás nem érhető el vagy szerverhibát ad, az nem fogyasztja a keretet, munkamenetenként legfeljebb 3-szor és látogatói hálózatonként 30 percenként legfeljebb 6-szor (szűrő: `trustorder_network_refund_limit`).
- Az **Áttekintés** oldalon az **Óránkénti ellenőrzési keret** és a **Rendelésleadási keret hálózatonként** sor **Betelt** jelzést kap, ha az elmúlt órában betelt, és az admin felület elrejthető figyelmeztetést mutat.

Tartós object cache nélkül a számlálók közelítőek, ha sok kérés érkezik ugyanabban a pillanatban. Tartós object cache-sel minden számolás atomi, és az elutasított ellenőrzés nem fogyaszt a keretből. Ha az object cache hibázik, a számlálók arra a kérésre transientekre váltanak, így a keretek akkor is érvényesek.

## Ha a jelentések nem mennek ki

A jelentések a háttérben mennek. Ha a szolgáltatás foglalt vagy nem érhető el, a bővítmény 1, 5, 30 és 120 perc múlva újrapróbálja, utána sikertelennek jelöli a jelentést. Egy rendelés ellenőrzéséhez vagy újraküldéséhez használd a `wp trustorder signal status` és a `wp trustorder signal send` parancsot ([WP-CLI](https://docs.uptools.io/hu/trustorder/wordpress/wp-cli/)).

A bővítmény kikapcsolása törli a függőben lévő háttérfeladatait. Visszakapcsolás után indítsd el a [visszatöltést](https://docs.uptools.io/hu/trustorder/wordpress/orders/).

## Teszt mód

A `to_test_...` kulccsal a bolt teszt módban van: az **Áttekintés** és a **Beállítások** oldalon **Teszt mód** jelölés látszik, az adatok pedig külön tesztadatbázisba kerülnek. Az éles bolthoz `to_live_...` kulcsot használj.

- A teszt- és az éles kulcs külön tartja nyilván a jelentéseket. Kulcsváltás után a rendelés az új környezetbe újra kimegy.
- A kulcsváltás nem vonja vissza a másik kulccsal már elküldött jelentéseket.
- A visszatöltés környezetenként külön tartja a haladást, és csak az elmentett kulcs környezetében fut.

## API

A TrustOrder API leírása itt van: [TrustOrder API](https://docs.uptools.io/hu/trustorder/api/).
