@flopay/react 0.2.1 → 0.3.4

package/dist/index.d.cts

@@ -81,11 +81,20 @@ interface FloPayCheckoutProps {
     buttonsTheme?: _flopay_shared.ButtonsLayoutTheme;
     /** Custom style overrides for the buttons layout. Merged on top of the theme preset. */
     buttonsStyles?: _flopay_shared.ButtonsLayoutStyles;
+    /** Custom React content rendered inside the card button when `layout="buttons"`. */
+    cardButtonContent?: React.ReactNode;
     /**
      * Called when a payment method button is clicked.
      * `method`: `'card'` | `'paypal'` | `'apple_pay'` | `'google_pay'`
      */
     onButtonClick?: (method: string) => void;
+    /**
+     * Enable AVS (Address Verification). Shows country dropdown + ZIP/postcode input
+     * in the card form. When enabled, billing_details are passed to Stripe for AVS checks.
+     */
+    enableAVS?: boolean;
+    /** Layout for AVS fields: 'row' (side-by-side, default) or 'column' (stacked). */
+    avsLayout?: 'row' | 'column';
     /** Label for the submit button. */
     submitLabel?: string;
     /** Additional CSS class for the wrapper. */
@@ -129,7 +138,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, onButtonClick, 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, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, onButtonClick, enableAVS, avsLayout, submitLabel, className, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -369,11 +378,28 @@ interface SplitCardFormProps {
     buttonsTheme?: _flopay_shared.ButtonsLayoutTheme;
     /** Custom style overrides for the `buttons` layout. Merged on top of the theme preset. */
     buttonsStyles?: _flopay_shared.ButtonsLayoutStyles;
+    /** Custom React content rendered inside the card button when `layout="buttons"`. */
+    cardButtonContent?: React.ReactNode;
     /**
      * Called when a payment method button is clicked.
      * `method`: `'card'` | `'paypal'` | `'apple_pay'` | `'google_pay'`
      */
     onButtonClick?: (method: string) => void;
+    /**
+     * Enable AVS (Address Verification). Shows country dropdown + ZIP/postcode input.
+     * When enabled, billing_details are passed to Stripe's createPaymentMethod for AVS checks.
+     */
+    enableAVS?: boolean;
+    /** Layout for AVS fields: 'row' (side-by-side, default) or 'column' (stacked). */
+    avsLayout?: 'row' | 'column';
+    /** Pre-filled country code (ISO 3166-1 alpha-2) for AVS. */
+    country?: string;
+    /** Pre-filled ZIP/postal code for AVS. */
+    zip?: string;
+    /** Callback when AVS country changes. */
+    onCountryChange?: (country: string) => void;
+    /** Callback when AVS ZIP/postal code changes. */
+    onZipChange?: (zip: string) => void;
     /** Total amount in cents (smallest currency unit). Used for wallet/PayPal Elements config. */
     totalAmount?: number;
     /** Currency code (used for PayPal Elements config). */

package/dist/index.d.ts

@@ -81,11 +81,20 @@ interface FloPayCheckoutProps {
     buttonsTheme?: _flopay_shared.ButtonsLayoutTheme;
     /** Custom style overrides for the buttons layout. Merged on top of the theme preset. */
     buttonsStyles?: _flopay_shared.ButtonsLayoutStyles;
+    /** Custom React content rendered inside the card button when `layout="buttons"`. */
+    cardButtonContent?: React.ReactNode;
     /**
      * Called when a payment method button is clicked.
      * `method`: `'card'` | `'paypal'` | `'apple_pay'` | `'google_pay'`
      */
     onButtonClick?: (method: string) => void;
+    /**
+     * Enable AVS (Address Verification). Shows country dropdown + ZIP/postcode input
+     * in the card form. When enabled, billing_details are passed to Stripe for AVS checks.
+     */
+    enableAVS?: boolean;
+    /** Layout for AVS fields: 'row' (side-by-side, default) or 'column' (stacked). */
+    avsLayout?: 'row' | 'column';
     /** Label for the submit button. */
     submitLabel?: string;
     /** Additional CSS class for the wrapper. */
@@ -129,7 +138,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, fallbackPublishableKey, loading: loadingNode, error: errorNode, onComplete, onError, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, onButtonClick, 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, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, onButtonClick, enableAVS, avsLayout, submitLabel, className, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -369,11 +378,28 @@ interface SplitCardFormProps {
     buttonsTheme?: _flopay_shared.ButtonsLayoutTheme;
     /** Custom style overrides for the `buttons` layout. Merged on top of the theme preset. */
     buttonsStyles?: _flopay_shared.ButtonsLayoutStyles;
+    /** Custom React content rendered inside the card button when `layout="buttons"`. */
+    cardButtonContent?: React.ReactNode;
     /**
      * Called when a payment method button is clicked.
      * `method`: `'card'` | `'paypal'` | `'apple_pay'` | `'google_pay'`
      */
     onButtonClick?: (method: string) => void;
+    /**
+     * Enable AVS (Address Verification). Shows country dropdown + ZIP/postcode input.
+     * When enabled, billing_details are passed to Stripe's createPaymentMethod for AVS checks.
+     */
+    enableAVS?: boolean;
+    /** Layout for AVS fields: 'row' (side-by-side, default) or 'column' (stacked). */
+    avsLayout?: 'row' | 'column';
+    /** Pre-filled country code (ISO 3166-1 alpha-2) for AVS. */
+    country?: string;
+    /** Pre-filled ZIP/postal code for AVS. */
+    zip?: string;
+    /** Callback when AVS country changes. */
+    onCountryChange?: (country: string) => void;
+    /** Callback when AVS ZIP/postal code changes. */
+    onZipChange?: (zip: string) => void;
     /** Total amount in cents (smallest currency unit). Used for wallet/PayPal Elements config. */
     totalAmount?: number;
     /** Currency code (used for PayPal Elements config). */