Tovább a tartalomhoz

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á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

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:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások