# Hibaelhárítás

> A „Unable to create webhook in Stripe” hiba okai és javítása, valamint a leggyakoribb buktatók.

## „Unable to create webhook in Stripe”

A **Configure Webhooks** gomb megnyomásakor ezt a hibaüzenetet kaphatod:

> Unable to create webhook in Stripe. Please use the “Configure Webhooks” button below to try again. Error: You have reached the maximum of 3 unique versions of test webhook endpoints / event destinations. Please upgrade the versions of older test webhook endpoints or event destinations to match the versions of newer test webhook endpoints / event destinations.

Élő módban az üzenetben „test” helyett „live” áll. A hibát a Stripe adja, nem a Gravity Forms. Nem a webhookok számával van baj, hanem azzal, hogy a webhookjaid hány különböző API-verziót használnak.

### Miért történik

A Stripe-ban minden webhook-végpont egy API-verzióhoz kötött, ez határozza meg az események formátumát. A Stripe módonként (élő vagy teszt) legfeljebb 3 különböző API-verziót enged a webhook-végpontok között, a fiók alapértelmezett verzióját nem számítva.

A Stripe Add-On a webhookját mindig a Stripe legújabb API-verziójával hozza létre. Ha a fiókodban már három másik verzió van használatban (például régebbi Gravity Forms webhookoktól vagy más, Stripe-hoz kapcsolt bővítményektől), nincs hely egy újabbnak, és a Stripe ezt a hibát adja. Amíg nem szabadítasz fel egy verziót, a bővítmény nem tudja beállítani a webhookot.

Egy végpont a létrehozáskor a legújabb verzióra áll, és ott is marad, a Stripe újabb kiadásakor nem frissül magától. Ezért a „legújabb verziós” végpont is lehet régebbi annál, amit a bővítmény regisztrálni akar.

### API-verziók ellenőrzése

1. Jelentkezz be a Stripe-fiókodba, és nyisd meg a Workbench **Overview** oldalt.
2. Görgess az **API versions** részhez. Itt látod a fiókban használt API-verziókat. A lila sávval jelölt verziók kapnak eseményeket, azok, amelyeken nincs lila sáv, nem.
3. A Workbench **Webhooks** lapján látod, melyik végpont melyik verziót használja.

### Javítás

Fel kell szabadítanod legalább egy API-verziót. Két módszer van.

**Nem használt végpontok törlése.** Ha egy verzión nincs lila sáv, az azt használó végpontok nem kapnak eseményt. A **Webhooks** lapon keresd meg őket, és töröld, amire nincs szükséged, például a régi Gravity Forms végpontokat vagy megszűnt szolgáltatások végpontjait.

**Régebbi végpontok frissítése.** Ha egy régebbi verziójú végpont még használatban van, át kell vinni újabb verzióra. A Stripe nem engedi egy meglévő végpont API-verziójának módosítását, ezért hozz létre egy új végpontot ugyanazzal az URL-lel és eseményekkel az újabb verzión, majd töröld a régit.

Ha egy végpont másik bővítményhez, szolgáltatáshoz vagy egyedi integrációhoz tartozik, frissítés vagy törlés előtt egyeztess a fejlesztőjével, mert az újabb API-verzió megváltoztathatja a kapott események formátumát.

### Újrapróbálás

Ha felszabadítottál egy API-verziót, nyisd meg újra az **Űrlapok → Beállítások → Stripe** oldalt, és kattints a **Configure Webhooks** gombra. A bővítmény ezúttal a legújabb API-verzióval hozza létre a webhookot, és az állapot **Beállítva** lesz.

## Webhook állapota nem „Beállítva”

Ha az állapot **Nincs beállítva** vagy **Hibásan konfigurálva**, vagy a „beállítva, de nem ellenőrizhető” üzenet látszik, kattints a **Configure Webhook** gombra. Amíg a webhook nincs rendben, a WordPress-admin felületen egy értesítés is látszik.

## Az SSL-tanúsítvány szükséges üzenet

A **Stripe-fiók** panel csak `https://` címen jelenít meg csatlakozási lehetőséget. Telepítsd és kapcsold be az SSL-tanúsítványt a webhelyen, majd töltsd újra a beállítóoldalt.

## „Unnamed account” (Névtelen fiók)

Teszt módban ez azt jelenti, hogy a Stripe-fiókodnál nem volt rendben a kétlépcsős azonosítás. Válaszd le az újonnan létrejött névtelen fiókot, kapcsold be a 2FA-t a Stripe-ban, és csatlakozz újra.

## A Stripe Checkout oldal nem jelenik meg

A Stripe Checkout csak nyilvános weboldalon használható. Ha a webhely nem elérhető kívülről, a Stripe-oldal nem nyílik meg.

## A Stripe-mezőben nincsenek kártyaadat-mezők

Ellenőrizd, hogy:

- a Stripe-fiók csatlakoztatva van-e, és a fizetésbeszedés módja **Stripe-mező (Elements)**,
- az űrlaphoz tartozik-e aktív Stripe-feed,
- az oldal `https://` címen fut-e.
