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
Szekció neve “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.
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áulgform_stripe_payment_element_payment_methods_23a 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
cardmó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
typemező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_accountpé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
Szekció neve “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.
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
Szekció neve “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).
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:
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)
Szekció neve “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.
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:
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.
Készült: