Tovább a tartalomhoz

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

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:

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