# Fizetési szándék és Checkout-munkamenet szűrői

> A PaymentIntent adatainak és a Stripe Checkout munkamenet adatainak módosítása: leírás a kivonaton, termékképek, metaadat, mentett fizetési mód.

## `gform_stripe_payment_intent_pre_create`: a fizetési szándék adatai

A szűrő a Stripe PaymentIntent adatait módosítja a létrehozás előtt. Csak a **Termékek és szolgáltatások** feedekre vonatkozik: az előfizetéses feedek nem használnak PaymentIntentet, azokhoz a `gform_stripe_subscription_params_pre_update_customer` szűrőt használd (lásd [Előfizetés szűrői](https://hub.hellowp.io/hu/plugins/gravityformsstripe/fejlesztoknek-elofizetes-szurok/)). Stripe Checkout esetén a `gform_stripe_session_data` szűrő a megfelelő (lásd lejjebb).

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

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$data` | array | A fizetési szándék adatai. |
| `$feed` | Feed Object | A feldolgozott feed. |

Példa: a `statement_descriptor` (a kártyakivonaton megjelenő szöveg) megadása:

```php
add_filter( 'gform_stripe_payment_intent_pre_create', 'add_statement_descriptor', 10, 2 );
function add_statement_descriptor( $data, $feed ) {
    $data['statement_descriptor'] = 'STATEMENTDESC';

    return $data;
}
```

Példa: a fizetési mód hozzákapcsolása a Stripe-ügyfélhez a Stripe Card mező használatakor (`setup_future_usage`):

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

    return $data;
}, 10, 2 );
```

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

## `gform_stripe_session_data`: a Checkout-munkamenet adatai

Ha a fizetésbeszedés módja a **Stripe fizetési űrlap (Stripe Checkout)**, ezzel a szűrővel állíthatod be vagy módosíthatod a termék- és előfizetési adatokat, mielőtt a bővítmény létrehozza a Checkout-munkamenetet. Termékképek hozzáadására is jó. A bővítmény 3.0-s változatától érhető el.

```php
add_filter( 'gform_stripe_session_data', 'my_function', 10, 5 );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$session_data` | array | A munkamenet létrehozásának adatai, a Stripe Checkout Session létrehozási paraméterei szerint. |
| `$feed` | array | A feldolgozott feed. |
| `$submission_data` | array | Az ügyfél- és tranzakciós adatok. |
| `$form` | array | Az űrlap. |
| `$entry` | array | A bejegyzés. |

### Termékképek az Image Choices bővítménnyel

Az Image Choices bővítmény választóképeit a Checkout oldalon a tételekhez rendelheted (a `4` az űrlap azonosítója):

```php
add_filter( 'gform_stripe_session_data', function ( $session_data, $feed, $submission_data, $form, $entry ) {
    if ( $form['id'] === 4 ) {
        foreach ( $submission_data['line_items'] as $k => $line_item ) {
            $field = GFAPI::get_field( $form, $line_item['id'] );
            if ( rgar( $field, 'choices' ) ) {
                $image = gf_image_choices()->get_choice_image_src( $field, $line_item['name'] );
                if ( $image ) {
                    $session_data['line_items'][ $k ]['images'][] = $image;
                }
            }
        }
    }

    return $session_data;
}, 10, 5 );
```

### A `statement_descriptor` megadása

A régi `gform_stripe_charge_pre_create` szűrő helyett az új Stripe Checkoutban a `payment_intent_data` alá írhatsz:

```php
add_filter( 'gform_stripe_session_data', function ( $session_data, $feed, $submission_data, $form, $entry ) {
    if ( $form['id'] === 4 ) {
        $session_data['payment_intent_data']['statement_descriptor'] = 'STATEMENTDESC';
    }
    return $session_data;
}, 10, 5 );
```

A `payment_intent_data` alatt a Stripe Checkout Session létrehozásánál felsorolt PaymentIntent-paraméterek adhatók meg.

### További fizetésimód-típusok

A `payment_method_types` tömbbe további típusokat is felvehetsz (például `ideal`):

```php
add_filter( 'gform_stripe_session_data', function ( $session_data, $feed, $submission_data, $form, $entry ) {
    if ( $form['id'] === 4 ) {
        $session_data['payment_method_types'][] = 'ideal';
    }

    return $session_data;
}, 10, 5 );
```

A bővítmény jelenleg a kártya, a Google Pay és az Apple Pay használatára van hitelesítve. A más módon hozzáadott fizetési módok további műszaki követelmények miatt nem biztos, hogy működnek, és a Stripe saját feltételeihez is igazodniuk kell.

### Metaadat küldése a bejegyzés mentése előtt

A kérés az űrlap érvényesítése közben megy el, amikor a bejegyzés tulajdonságai (például az azonosító) még nem állnak rendelkezésre, és a mezők értéke később még változhat.

```php
add_filter( 'gform_stripe_session_data', function ( $session_data, $feed, $submission_data, $form, $entry ) {
    if ( ! empty( $session_data['payment_intent_data'] ) && $form['id'] === 4 ) {
        $metadata = gf_stripe()->get_stripe_meta_data( $feed, $entry, $form );
        if ( ! empty( $metadata ) ) {
            $session_data['payment_intent_data']['metadata'] = $metadata;
        }
    }

    return $session_data;
}, 10, 5 );
```

### A fizetési mód mentése későbbi használatra

A `setup_future_usage` paraméter a Stripe-nál létrehozott ügyfélhez kapcsolja a fizetési módot:

```php
add_filter( 'gform_stripe_session_data', function ( $session_data, $feed, $submission_data, $form, $entry ) {
    $session_data['payment_intent_data']['setup_future_usage'] = 'off_session';
    return $session_data;
}, 10, 5 );
```

### A `customer_creation` eltávolítása meglévő ügyfélnél

A Stripe API-ja hibát ad, ha a munkamenet létrehozásakor a `customer` és a `customer_creation` paraméter is szerepel. Ha a `gform_stripe_customer_id` szűrő már megadta a `customer` értékét, a másikat el kell távolítani:

```php
add_filter( 'gform_stripe_session_data', function ( $session_data ) {
    if ( ! empty( $session_data['customer'] ) ) {
        unset( $session_data['customer_creation'] );
    }

    return $session_data;
} );
```
