# A Payment Element szűrői

> A Stripe Payment Element fizetési módjai, az automatikus terhelést támogató módok, valamint a kezdeti és a frissített fizetési adatok szűrői.

Ezek a szűrők akkor számítanak, ha a Stripe-mezőben a **Stripe Payment Element** fizetésbeszedési módot használod. A kódot az aktív téma `functions.php` fájljába, egy saját funkciók bővítménybe vagy kódrészlet-kezelő bővítménybe teheted.

## `gform_stripe_payment_element_payment_methods`: a felkínált fizetési módok

Ezzel a szűrővel kézzel megadhatod, mely fizetési módok jöhetnek szóba a Stripe-mezőben.

```php
add_filter( 'gform_stripe_payment_element_payment_methods', function ( $payment_methods, $feed, $form ) {
    return array( 'card', 'us_bank_account', 'ideal', 'link' );
}, 10, 3 );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$payment_methods` | array | Az engedélyezőlistára kerülő fizetési módok. Csak az itt megadottak jöhetnek szóba. |
| `$feed` | array | A feldolgozott feed. |
| `$form` | array | Az űrlap, amelyből a bejegyzés keletkezett. |

Tudnivalók:

- **Feedenként fut.** Ha az űrlapon több Stripe-feed van, a szűrő mindegyikre külön lefut.
- **Űrlapra szabott változat.** A `gform_stripe_payment_element_payment_methods_{űrlap_azonosító}` néven (például `gform_stripe_payment_element_payment_methods_23` a 23-as űrlapra) csak egy űrlapot érint.
- **Felülírja a Stripe vezérlőpultot.** A **Beállítások → Fizetési módok** alatti beállítást írja felül: egy módot akkor is elérhetővé tesz, ha az le van tiltva vagy nincs bekapcsolva, és figyelmen kívül hagy egy bekapcsolt módot is. A változás nem látszik a csatlakoztatott Stripe vezérlőpulton.
- **Nem garantálja a megjelenést.** Ha egy módot nem lehet vagy nem szabad felkínálni, az nem jelenik meg, vagy hibaüzenet látszik.
- **A kártya nem kapcsolható ki.** A bővítmény megköveteli, hogy a `card` mód mindig elérhető legyen.
- **Alaphelyzetbe állítás.** Üres tömb visszaadásával a szűrő nem érvényesül, és a vezérlés visszakerül a Stripe vezérlőpulthoz.
- **A kódok.** A módok kódjait a Stripe PaymentMethod objektumának `type` mezője adja.
- **Hibák oka.** Egy mód hibát adhat, ha nem támogatja az előfizetést, a használt pénznemet vagy a kézi lehívást. Az `us_bank_account` például azt kívánja, hogy a kereskedő az Egyesült Államokban legyen, és a pénznem USD legyen. Európai fizetési módokhoz általában EUR kell.

## `gform_stripe_payment_element_subscriptions_automatic_charge_methods`: automatikus terhelést támogató módok

Előfizetést kétféleképpen lehet létrehozni: a vevő fizetési módját automatikusan terhelik, vagy számlát küldenek, és megvárják a kifizetését. Egyes fizetési módok csak a második módszert támogatják. Ez a szűrő a bővítmény beégetett listáját módosítja: hozzáadhatsz egy módot, amely később már támogatja az automatikus terhelést, vagy kivehetsz egyet, amely már nem.

```php
add_filter( 'gform_stripe_payment_element_subscriptions_automatic_charge_methods', function ( $methods, $feed, $form ) {
    $methods = array_merge( $methods, array( 'sofort' ) );
    unset( $methods['sepa_debit'] );

    return $methods;
}, 10, 3 );
```

Paraméterek: a módok tömbje (`$methods`), a feed (`$feed`) és az űrlap (`$form`). A szűrő a Stripe-bővítmény 5.0-s változatától érhető el.

## `gform_stripe_payment_element_initial_payment_information`: megszűnt

A szűrő a Payment Element megjelenítéséhez használt kezdeti fizetési adatokat írta felül. Elavult: helyette a `gform_stripe_payment_intent_pre_create` szűrőt használd (lásd [Fizetési szándék és Checkout-munkamenet szűrői](https://hub.hellowp.io/hu/plugins/gravityformsstripe/fejlesztoknek-fizetesi-szandek-es-munkamenet/)).

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

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$intent_information` | array | A kezdeti fizetési adatok, a Stripe PaymentIntent létrehozásának paraméterei szerint. |
| `$feed` | array | A feed. |
| `$form` | array | Az űrlap. |

Példa: a fizetési mód hozzákapcsolása az ügyfélhez a Payment Element megjelenítésekor (`setup_future_usage`). Ehhez a `gform_stripe_charge_pre_create` szűrőt is használnod kell:

```php
add_filter( 'gform_stripe_payment_element_initial_payment_information', function ( $intent_information, $feed, $form ) {
    gf_stripe()->log_debug( __METHOD__ . '(): Adding setup_future_usage payment intent for feed ' . rgars( $feed, 'meta/feedName' ) );
    $intent_information['setup_future_usage'] = 'off_session';

    return $intent_information;
}, 10, 3 );
```

A szűrő a Stripe-bővítmény 5.2-es változatában került be.

## `gform_stripe_payment_element_updated_payment_information`: frissített fizetési adatok (JavaScript)

Ez JavaScript-szűrő: a Payment Element adatait módosíthatod, mielőtt a bővítmény meghívja az `elements.update()` függvényt. Hasznos a pénznem vagy az összeg megváltoztatásához. A módosítható tulajdonságokat a Stripe `elements.update(options)` leírása sorolja fel.

A szűrő csak az űrlap előoldali JavaScriptjére hat. A beküldéskor érvényesítendő értékekhez a megfelelő PHP-szűrőket is meg kell valósítanod.

```js
gform.addFilter( 'gform_stripe_payment_element_updated_payment_information', function ( paymentInformation, feedId, formId ) {
    // Módosítsd az adatokat.
    return paymentInformation;
} );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `paymentInformation` | objektum | A frissített fizetési adatok. |
| `feedId` | szöveg | A feldolgozott feed azonosítója. |
| `formId` | szöveg | A feldolgozott űrlap azonosítója. |

Példa: az 5-ös azonosítójú űrlapon a pénznem euróra váltása. A PHP-oldalon a bejegyzés pénznemét és a Stripe-terhelés pénznemét kell átírni, az előoldalon pedig ezt a szűrőt kell használni:

```php
add_filter( 'gform_currency_pre_save_entry', function ( $currency, $form ) {
    if ( rgar( $form, 'id' ) == 5 ) {
        return 'EUR';
    }
    return $currency;
}, 10, 2 );

add_filter( 'gform_stripe_charge_pre_create', function ( $charge, $feed, $submission_data, $form, $entry ) {
    if ( rgar( $form, 'id' ) == 5 ) {
        $charge['currency'] = 'eur';
    }
    return $charge;
}, 10, 5 );

add_action( 'wp_footer', function () {
?>
<script type="text/javascript">
    jQuery( document ).ready( function () {
        gform.addFilter( 'gform_stripe_payment_element_updated_payment_information', function ( paymentInformation, feedId, formId ) {
            if ( formId == 5 ) {
                paymentInformation.currency = 'eur';
            }
            return paymentInformation;
        } );
    } );
</script>
<?php
} );
```

A JavaScript-kódot az oldal előoldali részébe kell betenni (például a fenti módon a `wp_footer` horoggal). A szűrő a Stripe-bővítmény 5.5.2-es változatában került be.
