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
Szekció neve “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). Stripe Checkout esetén a gform_stripe_session_data szűrő a megfelelő (lásd lejjebb).
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:
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):
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
Szekció neve “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.
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
Szekció neve “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):
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
Szekció neve “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:
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
Szekció neve “További fizetésimód-típusok”A payment_method_types tömbbe további típusokat is felvehetsz (például ideal):
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
Szekció neve “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.
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
Szekció neve “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:
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
Szekció neve “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:
add_filter( 'gform_stripe_session_data', function ( $session_data ) { if ( ! empty( $session_data['customer'] ) ) { unset( $session_data['customer_creation'] ); }
return $session_data;} );Készült: