# Hibakorlát és csak hitelesítés a Payment Elementnél

> A hibakorlát (rate limit) ideiglenes kikapcsolása teszteléshez és a Payment Elementtel használható csak hitelesítéses (authorization only) terhelés.

Két szűrő a Stripe-fizetések védelmét és az összeg zárolását érinti. A kódot az aktív téma `functions.php` fájljába, saját funkcióbővítő bővítménybe, saját Add-On-ba vagy kódrészlet-kezelő bővítménybe teheted.

## `gform_stripe_enable_rate_limits`: a hibakorlát kikapcsolása teszteléshez

A hibakorlát alapból be van kapcsolva: ha egy IP-címről öt hiba történik, a bővítmény egy órára letiltja azt a címet. Ha a naplóban `GFStripe::maybe_hit_rate_limits()` bejegyzést látsz, a korlát életbe lépett. A szűrővel ezt ideiglenesen kikapcsolhatod, amíg az űrlapot teszteled.

> **Figyelem**
>
> Éles (**Live**) módú Stripe-kapcsolatnál, az **Űrlapok → Beállítások → Stripe** oldalon beállítva, a korlátot csak rövid teszt erejéig kapcsold ki. A korlát a kártyateszteléses csalás (carding) ellen véd. Ha éles környezetben kikapcsolod, ellopott kártyákkal is indíthatók tranzakciók, ami több vitatott kártyaterheléshez vezethet.

```php
add_filter( 'gform_stripe_enable_rate_limits', 'your_function_name', 10, 2 );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$has_error` | bool | Be van-e kapcsolva a hibakorlát. Alapértéke `true`. |
| `$form_id` | int | Az elküldött űrlap azonosítója. |

Példa, amely az összes űrlapon kikapcsolja:

```php
add_filter( 'gform_stripe_enable_rate_limits', '__return_false' );
```

## `gform_stripe_payment_element_authorization_only`: csak hitelesítés a Payment Elementnél

A szűrő megakadályozza, hogy a bővítmény a bejegyzés mentése után azonnal terhelje (capture) a kártyát. Az összeg csak zárolódik (hitelesítés), a terhelést később a bejegyzés részletei oldaláról végezheted el.

Tudnivalók:

- Csak a **Termék és szolgáltatás** feedekre vonatkozik. Az előfizetéseknél nem érvényesül, mert ott az első fizetést azonnal be kell szedni.
- Csak akkor használd, ha a Stripe-mező beállításai között be van kapcsolva a **Stripe Payment Element használata**. Ha nem a Payment Elementet használod, a `gform_stripe_charge_authorization_only` szűrő való (lásd a [terhelésről és leírásról szóló fejezetet](https://hub.hellowp.io/hu/plugins/gravityformsstripe/fejlesztoknek-terheles-es-leiras/)).

```php
add_filter( 'gform_stripe_payment_element_authorization_only', 'your_function_name', 10, 3 );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$result` | bool | Hitelesítés történjen-e terhelés helyett. Alapértéke `false`. |
| `$form` | Form Object | A feldolgozott űrlap. |
| `$feed` | Feed Object | A feldolgozott feed. |

Példák:

```php
// 1. Minden termék- és szolgáltatásfeedre
add_filter( 'gform_stripe_payment_element_authorization_only', '__return_true' );
```

```php
// 2. Egy adott űrlapra
add_filter( 'gform_stripe_payment_element_authorization_only', function ( $result, $form, $feed ) {
    if ( $form['id'] === 1 ) {
        return true; // csak hitelesítés
    }
    return false; // a fizetés automatikus terhelése
}, 10, 3 );
```

```php
// 3. Egy adott feedre (a feed nevét cseréld a sajátodra)
add_filter( 'gform_stripe_payment_element_authorization_only', 'stripe_charge_authorization_only', 10, 3 );
function stripe_charge_authorization_only( $result, $form, $feed ) {
    $feed_name = rgars( $feed, 'meta/feedName' );
    if ( $feed_name == 'a feed neve' ) {
        return true;
    }
    return $result;
}
```
