@flopay/react 0.4.7 → 0.4.9

package/dist/index.d.cts

@@ -26,6 +26,8 @@ interface FloPayProviderProps {
         currency?: string;
         /** How payment methods are created. 'manual' (default for cards) or 'auto' (needed for PayPal). */
         paymentMethodCreation?: 'manual' | 'auto';
+        /** Requests reusable payment credentials for future payments. */
+        setupFutureUsage?: 'off_session' | 'on_session';
         /** Billing API base URL. Set once here so child components don't need to repeat it. */
         billingApiUrl?: string;
     };
@@ -60,15 +62,6 @@ interface FloPayCheckoutProps {
     appearance?: FloPayAppearance;
     /** Locale for payment elements (default: 'auto'). */
     locale?: string;
-    /**
-     * Fallback Stripe publishable key — used only if the session response
-     * doesn't include `gatewayData.publishableKey`.
-     *
-     * When the backend returns full session data (e.g. via `createSession`
-     * with `?expand=true`), the response's `gatewayData.publishableKey` is
-     * the single source of truth and this prop is not needed.
-     */
-    fallbackPublishableKey?: string;
     /** Custom loading UI. Defaults to a simple centered spinner. */
     loading?: React.ReactNode;
     /** Custom error UI. Receives the error. Defaults to showing the error message. */
@@ -169,7 +162,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-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, showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, initialErrorMessage, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
+declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, initialErrorMessage, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -538,6 +531,7 @@ interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttribu
     sessionId?: string;
     createSession?: InlineSessionDraft;
     paymentMethodId?: string;
+    checkoutMethod?: CheckoutButtonMethod;
     clientId?: string;
     items?: CheckoutItem[];
     subscriptions?: CheckoutSubscription[];
@@ -549,7 +543,6 @@ interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttribu
     utmMetadata?: InlineSessionDraft['utmMetadata'];
     billingApiUrl?: string;
     locale?: string;
-    fallbackPublishableKey?: string;
     buttonsTheme?: ButtonsLayoutTheme;
     buttonsStyles?: ButtonsLayoutStyles;
     onSuccess?: (event: FloPayAutomaticPaymentSuccessEvent) => void;
@@ -557,6 +550,6 @@ interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttribu
     onDecline?: (decline: DeclineEvent) => void;
     children?: React.ReactNode;
 }
-declare function FloPayAutomaticPaymentButton({ sessionId, createSession, paymentMethodId, clientId, items, subscriptions, account, successUrl, cancelUrl, couponCodes, tagsData, utmMetadata, billingApiUrl, locale, fallbackPublishableKey, buttonsTheme, buttonsStyles: stylesOverride, onSuccess, onError, onDecline, children, disabled, type, style, ...buttonProps }: FloPayAutomaticPaymentButtonProps): react_jsx_runtime.JSX.Element;
+declare function FloPayAutomaticPaymentButton({ sessionId, createSession, paymentMethodId, checkoutMethod, clientId, items, subscriptions, account, successUrl, cancelUrl, couponCodes, tagsData, utmMetadata, billingApiUrl, locale, buttonsTheme, buttonsStyles: stylesOverride, onSuccess, onError, onDecline, children, disabled, type, style, ...buttonProps }: FloPayAutomaticPaymentButtonProps): react_jsx_runtime.JSX.Element;
 
 export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayAutomaticPaymentButton, type FloPayAutomaticPaymentButtonProps, type FloPayAutomaticPaymentSuccessEvent, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };

package/dist/index.d.ts

@@ -26,6 +26,8 @@ interface FloPayProviderProps {
         currency?: string;
         /** How payment methods are created. 'manual' (default for cards) or 'auto' (needed for PayPal). */
         paymentMethodCreation?: 'manual' | 'auto';
+        /** Requests reusable payment credentials for future payments. */
+        setupFutureUsage?: 'off_session' | 'on_session';
         /** Billing API base URL. Set once here so child components don't need to repeat it. */
         billingApiUrl?: string;
     };
@@ -60,15 +62,6 @@ interface FloPayCheckoutProps {
     appearance?: FloPayAppearance;
     /** Locale for payment elements (default: 'auto'). */
     locale?: string;
-    /**
-     * Fallback Stripe publishable key — used only if the session response
-     * doesn't include `gatewayData.publishableKey`.
-     *
-     * When the backend returns full session data (e.g. via `createSession`
-     * with `?expand=true`), the response's `gatewayData.publishableKey` is
-     * the single source of truth and this prop is not needed.
-     */
-    fallbackPublishableKey?: string;
     /** Custom loading UI. Defaults to a simple centered spinner. */
     loading?: React.ReactNode;
     /** Custom error UI. Receives the error. Defaults to showing the error message. */
@@ -169,7 +162,7 @@ interface FloPayCheckoutProps {
  * />
  * ```
  */
-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, showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, initialErrorMessage, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
+declare function FloPayCheckout({ sessionId: sessionIdProp, createSession: createSessionParams, billingApiUrl, appearance, locale, loading: loadingNode, error: errorNode, onComplete, onError, onDecline, onFullNameChange, onCountryChange, onZipChange, showPayPal, showApplePay, showGooglePay, layout, buttonsTheme, buttonsStyles, cardButtonContent, cardBackButtonContent, cardTitleContent, showSecurityFooter, onButtonClick, onBeforeButtonClick, enableAVS, avsLayout, submitLabel, className, initialErrorMessage, children, checkoutMode: checkoutModeProp, confirmLabel, renderConfirmButton, onSessionCompleted, }: FloPayCheckoutProps): React.ReactElement;
 
 /**
  * Returns the current `FloPay` instance, or `null` if the provider
@@ -538,6 +531,7 @@ interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttribu
     sessionId?: string;
     createSession?: InlineSessionDraft;
     paymentMethodId?: string;
+    checkoutMethod?: CheckoutButtonMethod;
     clientId?: string;
     items?: CheckoutItem[];
     subscriptions?: CheckoutSubscription[];
@@ -549,7 +543,6 @@ interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttribu
     utmMetadata?: InlineSessionDraft['utmMetadata'];
     billingApiUrl?: string;
     locale?: string;
-    fallbackPublishableKey?: string;
     buttonsTheme?: ButtonsLayoutTheme;
     buttonsStyles?: ButtonsLayoutStyles;
     onSuccess?: (event: FloPayAutomaticPaymentSuccessEvent) => void;
@@ -557,6 +550,6 @@ interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttribu
     onDecline?: (decline: DeclineEvent) => void;
     children?: React.ReactNode;
 }
-declare function FloPayAutomaticPaymentButton({ sessionId, createSession, paymentMethodId, clientId, items, subscriptions, account, successUrl, cancelUrl, couponCodes, tagsData, utmMetadata, billingApiUrl, locale, fallbackPublishableKey, buttonsTheme, buttonsStyles: stylesOverride, onSuccess, onError, onDecline, children, disabled, type, style, ...buttonProps }: FloPayAutomaticPaymentButtonProps): react_jsx_runtime.JSX.Element;
+declare function FloPayAutomaticPaymentButton({ sessionId, createSession, paymentMethodId, checkoutMethod, clientId, items, subscriptions, account, successUrl, cancelUrl, couponCodes, tagsData, utmMetadata, billingApiUrl, locale, buttonsTheme, buttonsStyles: stylesOverride, onSuccess, onError, onDecline, children, disabled, type, style, ...buttonProps }: FloPayAutomaticPaymentButtonProps): react_jsx_runtime.JSX.Element;
 
 export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayAutomaticPaymentButton, type FloPayAutomaticPaymentButtonProps, type FloPayAutomaticPaymentSuccessEvent, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };