@flopay/react 0.3.15 → 0.3.19

package/dist/index.d.cts

@@ -72,6 +72,12 @@ interface FloPayCheckoutProps {
     onError?: (error: FloPayError) => void;
     /** Called when a payment is declined or the authentication step fails. */
     onDecline?: (decline: DeclineEvent) => void;
+    /** Called when the full cardholder name input changes. */
+    onFullNameChange?: (value: string) => void;
+    /** Called when the AVS country dropdown changes. */
+    onCountryChange?: (country: string) => void;
+    /** Called when the AVS ZIP/postcode input changes. */
+    onZipChange?: (zip: string) => void;
     /** Whether to show the PayPal button (default: true). */
     showPayPal?: boolean;
     /** Whether to show Apple Pay button (default: true). Only renders on supported devices. */
@@ -96,10 +102,10 @@ interface FloPayCheckoutProps {
      */
     onButtonClick?: (method: CheckoutButtonMethod) => void;
     /**
-     * Called before the credit/debit card button continues.
-     * Card only: this does not run for PayPal or wallet buttons.
+     * Called before a payment button continues in `layout="buttons"`.
+     * Runs for card, PayPal, Apple Pay, and Google Pay.
      * In `layout="buttons"` with `createSession`, the returned patch is merged
-     * into the inline session params before the real card session is created.
+     * into the inline session params before the selected flow continues.
      */
     onBeforeButtonClick?: (event: BeforeButtonClickEvent) => void | false | Promise<void | false | InlineSessionPatch> | InlineSessionPatch;
     /**
@@ -152,7 +158,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
+declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -366,6 +372,8 @@ interface SplitCardFormProps {
     error?: string | null;
     /** Called when internal error state changes. */
     onErrorChange?: (error: string | null) => void;
+    /** Callback when the full cardholder name input changes. */
+    onFullNameChange?: (value: string) => void;
     /** Callback when first name changes (from the name input). */
     onFirstNameChange?: (value: string) => void;
     /** Callback when last name changes (from the name input). */
@@ -409,8 +417,8 @@ interface SplitCardFormProps {
      */
     onButtonClick?: (method: CheckoutButtonMethod) => void;
     /**
-     * Called before the credit/debit card button continues.
-     * Card only: this does not run for PayPal or wallet buttons.
+     * Called before a payment button continues in `layout="buttons"`.
+     * Runs for card, PayPal, Apple Pay, and Google Pay.
      */
     onBeforeButtonClick?: (event: BeforeButtonClickEvent) => MaybePromise<void | false | InlineSessionPatch>;
     /**

package/dist/index.d.ts

@@ -72,6 +72,12 @@ interface FloPayCheckoutProps {
     onError?: (error: FloPayError) => void;
     /** Called when a payment is declined or the authentication step fails. */
     onDecline?: (decline: DeclineEvent) => void;
+    /** Called when the full cardholder name input changes. */
+    onFullNameChange?: (value: string) => void;
+    /** Called when the AVS country dropdown changes. */
+    onCountryChange?: (country: string) => void;
+    /** Called when the AVS ZIP/postcode input changes. */
+    onZipChange?: (zip: string) => void;
     /** Whether to show the PayPal button (default: true). */
     showPayPal?: boolean;
     /** Whether to show Apple Pay button (default: true). Only renders on supported devices. */
@@ -96,10 +102,10 @@ interface FloPayCheckoutProps {
      */
     onButtonClick?: (method: CheckoutButtonMethod) => void;
     /**
-     * Called before the credit/debit card button continues.
-     * Card only: this does not run for PayPal or wallet buttons.
+     * Called before a payment button continues in `layout="buttons"`.
+     * Runs for card, PayPal, Apple Pay, and Google Pay.
      * In `layout="buttons"` with `createSession`, the returned patch is merged
-     * into the inline session params before the real card session is created.
+     * into the inline session params before the selected flow continues.
      */
     onBeforeButtonClick?: (event: BeforeButtonClickEvent) => void | false | Promise<void | false | InlineSessionPatch> | InlineSessionPatch;
     /**
@@ -152,7 +158,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
+declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -366,6 +372,8 @@ interface SplitCardFormProps {
     error?: string | null;
     /** Called when internal error state changes. */
     onErrorChange?: (error: string | null) => void;
+    /** Callback when the full cardholder name input changes. */
+    onFullNameChange?: (value: string) => void;
     /** Callback when first name changes (from the name input). */
     onFirstNameChange?: (value: string) => void;
     /** Callback when last name changes (from the name input). */
@@ -409,8 +417,8 @@ interface SplitCardFormProps {
      */
     onButtonClick?: (method: CheckoutButtonMethod) => void;
     /**
-     * Called before the credit/debit card button continues.
-     * Card only: this does not run for PayPal or wallet buttons.
+     * Called before a payment button continues in `layout="buttons"`.
+     * Runs for card, PayPal, Apple Pay, and Google Pay.
      */
     onBeforeButtonClick?: (event: BeforeButtonClickEvent) => MaybePromise<void | false | InlineSessionPatch>;
     /**