# Kapcsolat és átirányítás: API-mód, Stripe Connect, megszakítási cím

> Az API-mód felülírása, a Stripe Connect kikapcsolása, a Stripe-ból visszatérő vásárló címeinek és a kiszolgáló portjának módosítása szűrőkkel.

Ez a fejezet öt PHP-szűrőt mutat be, amelyekkel a Stripe-kapcsolat működését és a Stripe Checkoutból visszatérő vásárló útját módosíthatod. A kódot az aktív téma `functions.php` fájljába, egy saját funkcióbővítő bővítménybe, egy saját Add-On-ba vagy egy kódrészlet-kezelő bővítménybe (snippets plugin) teheted.

## `gform_stripe_api_mode`: éles vagy teszt mód kényszerítése

A szűrővel az API módját állíthatod „live” (éles) vagy „test” (teszt) értékre, függetlenül attól, mit választottál a **Űrlapok → Beállítások → Stripe** oldalon.

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

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$api_mode` | string | Az API módja: `live` vagy `test`. |
| `$feed_id` | int | A szűrő környezete. Ha `null`, a globális kapcsolati beállítások érvényesek. Ha meg van adva, a mód a feedhez tartozó kapcsolatra vonatkozik. |

Mód beállítása az egész webhelyen:

```php
add_filter( 'gform_stripe_api_mode', function ( $api_mode, $feed_id ) {
    return 'live';
}, 10, 2 );
```

Mód beállítása csak egy adott feedre (itt az 521-es azonosítójúra):

```php
add_filter( 'gform_stripe_api_mode', function ( $api_mode, $feed_id ) {
    if ( $feed_id === 521 ) {
        return 'live';
    }
    return $api_mode;
}, 10, 2 );
```


## `gform_stripe_connect_enabled`: a Stripe Connect kikapcsolása

Alapértelmezés szerint új telepítéseknél a bővítmény a Stripe Connect (OAuth) kapcsolatot használja. Ezzel a szűrővel kikapcsolhatod, és visszatérhetsz a régi, API-kulcsos kapcsolati módhoz: ilyenkor a régi beállítóképernyő jelenik meg a Connect-képernyő helyett.

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

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$stripe_connect_enabled` | boolean | Új telepítéseknél alapból `true`. `false` esetén a régi beállítóképernyő látszik. |

Tudnivalók:

- A szűrő beállítása után előbb le kell választanod a webhelyet a Stripe-ról, hogy a kulcsmezők megjelenjenek.
- A kódot az aktív téma `functions.php` fájljába tedd.

> **Figyelem**
>
> **Biztonsági figyelmeztetés.** A Stripe Connect kikapcsolásával a webhely már nem a biztonságos OAuth-módszerrel csatlakozik a Stripe-hoz. Az OAuth-nál csak egy webhelyspecifikus kulcs kerül az adatbázisba, aminek az adatbázis kiszivárgása esetén korlátozott a felhasználhatósága, és közvetlenül nem lehet vele hozzáférni a Stripe-fiókhoz. A régi módban viszont a tényleges Stripe API-kulcsaid kerülnek az adatbázisba, amelyekkel a Stripe szolgáltatásainak széles köre elérhető. Ha az adatbázishoz rosszindulatú támadó vagy rossz szándékú jogosult felhasználó hozzáfér, a kockázat nagyobb.

## `gform_stripe_cancel_url`: a megszakítás utáni cím

Ha a vásárló a Stripe Checkout oldalán megszakítja a fizetést, a Stripe visszairányítja a webhelyedre. A szűrővel ennek a visszatérési címnek (a Stripe-munkamenet cancel URL-jének) a módosítására használhatod.

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

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$url` | string | A szűrendő cím. |
| `$form_id` | int | Az elküldött űrlap azonosítója. |

Példa: a cím gazdagépnevének cseréje (helyi fejlesztői környezetből éles tartományra):

```php
add_filter( 'gform_stripe_cancel_url', function ( $url, $form_id ) {
    GFCommon::log_debug( __METHOD__ . '(): Original URL: ' . $url );
    // Cseréld az example.com-ot a saját tartományodra.
    $url = str_replace( 'localhost', 'example.com', $url );
    GFCommon::log_debug( __METHOD__ . '(): New URL: ' . $url );
    return $url;
}, 10, 2 );
```

A kódot az aktív téma `functions.php` fájljába tedd.

## `gform_stripe_success_url`: a sikeres fizetés utáni cím

A szűrő a Stripe-munkamenet sikeres visszatérési címét (success URL) módosítja, vagyis azt a címet, ahová a vásárló a Stripe oldalán befejezett fizetés után kerül.

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

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$url` | string | A szűrendő cím. |
| `$form_id` | int | Az elküldött űrlap azonosítója. |
| `$query` | string | A cím lekérdezési (query string) része. |

Példa: ha a webhely valamiért `localhost` tartománnyal adja át a címet, ezzel kicserélheted a saját tartományodra:

```php
add_filter( 'gform_stripe_success_url', function ( $url, $form_id, $query ) {
    GFCommon::log_debug( __METHOD__ . '(): Original URL: ' . $url );
    // Cseréld az example.com-ot a saját tartományodra.
    $url = str_replace( 'localhost', 'example.com', $url );
    GFCommon::log_debug( __METHOD__ . '(): New URL: ' . $url );
    return $url;
}, 10, 3 );
```

A kódot az aktív téma `functions.php` fájljába tedd.

## `gform_stripe_url_port`: a kiszolgáló portja a címekben

Ha a webhely nem a 80-as porton fut, a szűrővel megadhatod, melyik portot használja a bővítmény. Az alapérték a kiszolgáló portja (`$_SERVER['SERVER_PORT']`).

```php
add_filter( 'gform_stripe_url_port', 'your_function_name' );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$server_port` | string | Az alapértelmezett kiszolgálóport. |

Példa:

```php
add_filter( 'gform_stripe_url_port', function ( $server_port ) {
    gf_stripe()->log_debug( __METHOD__ . '(): Original port: ' . $server_port );
    $server_port = '80'; // A 80 helyére írd a használni kívánt portot.
    gf_stripe()->log_debug( __METHOD__ . '(): Custom port: ' . $server_port );
    return $server_port;
} );
```

A kódot az aktív téma `functions.php` fájljába tedd.
