UNPKG

@stripe/react-connect-js

Version:

React components for Connect.js and Connect embedded components

127 lines (126 loc) 7.6 kB
/// <reference types="react" /> import * as connectJs from "@stripe/connect-js"; import { LoadError, LoaderStart, NotificationCount, StepChange, PaymentsListDefaultFilters, ConnectElementTagName, ConnectHTMLElementRecord } from "@stripe/connect-js"; type FetchEphemeralKeyFunction = (fetchParams: { issuingCard: string; nonce: string; }) => Promise<{ issuingCard: string; nonce: string; ephemeralKeySecret: string; }>; type CommonComponentProps = { onLoaderStart?: ({ elementTagName }: LoaderStart) => void; onLoadError?: ({ error, elementTagName }: LoadError) => void; }; declare const ConnectPayments: ({ defaultFilters, onLoadError, onLoaderStart }: { defaultFilters?: PaymentsListDefaultFilters | undefined; } & CommonComponentProps) => JSX.Element; declare const ConnectPayouts: ({ onLoadError, onLoaderStart }: CommonComponentProps) => JSX.Element; declare const ConnectPaymentDetails: ({ payment, onClose, onLoadError, onLoaderStart }: { payment: string; onClose: () => void; } & CommonComponentProps) => JSX.Element | null; declare const ConnectPaymentDisputes: ({ payment, onDisputesLoaded, onLoadError, onLoaderStart }: { payment: string; onDisputesLoaded?: (({ total }: { total: number; }) => void) | undefined; } & CommonComponentProps) => JSX.Element | null; declare const ConnectDisputesList: ({ onLoadError, onLoaderStart }: CommonComponentProps) => JSX.Element | null; type CollectionOptions = { fields: "currently_due" | "eventually_due"; futureRequirements?: "omit" | "include"; }; declare const ConnectAccountOnboarding: ({ onExit, recipientTermsOfServiceUrl, fullTermsOfServiceUrl, privacyPolicyUrl, skipTermsOfServiceCollection, collectionOptions, onLoadError, onLoaderStart, onStepChange }: { onExit: () => void; onStepChange?: ((stepChange: StepChange) => void) | undefined; recipientTermsOfServiceUrl?: string | undefined; fullTermsOfServiceUrl?: string | undefined; privacyPolicyUrl?: string | undefined; skipTermsOfServiceCollection?: boolean | undefined; collectionOptions?: CollectionOptions | undefined; } & CommonComponentProps) => JSX.Element | null; declare const ConnectAccountManagement: ({ collectionOptions, onLoadError, onLoaderStart }: { collectionOptions?: CollectionOptions | undefined; } & CommonComponentProps) => JSX.Element | null; declare const ConnectNotificationBanner: ({ collectionOptions, onNotificationsChange, onLoadError, onLoaderStart }: { collectionOptions?: CollectionOptions | undefined; onNotificationsChange?: (({ total, actionRequired }: NotificationCount) => void) | undefined; } & CommonComponentProps) => JSX.Element | null; declare const ConnectIssuingCard: ({ defaultCard, cardSwitching, showSpendControls, fetchEphemeralKey, onLoadError, onLoaderStart }: { defaultCard?: string | undefined; cardSwitching?: boolean | undefined; showSpendControls?: boolean | undefined; fetchEphemeralKey?: FetchEphemeralKeyFunction | undefined; } & CommonComponentProps) => JSX.Element; declare const ConnectIssuingCardsList: ({ showSpendControls, issuingProgram, fetchEphemeralKey, onLoadError, onLoaderStart }: { showSpendControls?: boolean | undefined; issuingProgram?: string | undefined; fetchEphemeralKey?: FetchEphemeralKeyFunction | undefined; } & CommonComponentProps) => JSX.Element; declare const ConnectFinancialAccount: ({ financialAccount, onLoadError, onLoaderStart }: { financialAccount: string; } & CommonComponentProps) => JSX.Element; declare const ConnectFinancialAccountTransactions: ({ financialAccount, onLoadError, onLoaderStart }: { financialAccount: string; } & CommonComponentProps) => JSX.Element; declare const ConnectDocuments: ({ onLoadError, onLoaderStart }: CommonComponentProps) => JSX.Element; declare const ConnectPayoutsList: ({ onLoadError, onLoaderStart }: CommonComponentProps) => JSX.Element; declare const ConnectBalances: ({ onLoadError, onLoaderStart }: CommonComponentProps) => JSX.Element; declare const ConnectTaxRegistrations: ({ onLoadError, onLoaderStart, displayCountries, onAfterTaxRegistrationAdded }: { displayCountries?: string[] | undefined; onAfterTaxRegistrationAdded?: (({ id }: { id: string; }) => void) | undefined; } & CommonComponentProps) => JSX.Element; declare const ConnectTaxSettings: ({ onLoadError, onLoaderStart, hideProductTaxCodeSelector, displayHeadOfficeCountries, onTaxSettingsUpdated }: { hideProductTaxCodeSelector?: boolean | undefined; displayHeadOfficeCountries?: string[] | undefined; onTaxSettingsUpdated?: (({ id }: { id: string; }) => void) | undefined; } & CommonComponentProps) => JSX.Element; declare const ConnectInstantPayoutsPromotion: ({ onInstantPayoutsPromotionLoaded, onInstantPayoutCreated, onLoadError, onLoaderStart }: { onInstantPayoutsPromotionLoaded?: (({ promotionShown }: { promotionShown: boolean; }) => void) | undefined; onInstantPayoutCreated?: (({ payoutId }: { payoutId: string; }) => void) | undefined; } & CommonComponentProps) => JSX.Element; type ConnectComponentsPayload = { connectInstance: connectJs.StripeConnectInstance; }; declare const ConnectComponentsProvider: ({ connectInstance, children }: { connectInstance: connectJs.StripeConnectInstance; children: any; }) => JSX.Element; declare const useConnectComponents: () => ConnectComponentsPayload; declare const useCreateComponent: <T extends ConnectElementTagName>(tagName: T) => { wrapper: JSX.Element; component: ConnectHTMLElementRecord[T] | null; }; /** * @deprecated The method should not be used as we are deprecating the use of attributes directly. * Define a setter for your use case and use useUpdateWithSetter instead. */ declare const useAttachAttribute: (component: HTMLElement | null, attribute: string, value: string | boolean | undefined) => void; declare enum ConnectElementEventNames { exit = "exit", close = "close", instantPayoutCreated = "instantpayoutcreated" } /** * @deprecated The method should not be used as we are deprecating the use of events directly. Define a setter for * your use case and use useUpdateWithSetter instead. */ declare const useAttachEvent: (component: HTMLElement | null, eventName: ConnectElementEventNames, listener: () => void) => void; declare const useUpdateWithSetter: <T extends HTMLElement, V extends string | boolean | PaymentsListDefaultFilters | string[] | FetchEphemeralKeyFunction | CollectionOptions | (() => void) | ((notificationCount: NotificationCount) => void) | ((loaderStart: LoaderStart) => void) | ((loaderError: LoadError) => void) | ((stepChange: StepChange) => void) | (({ id }: { id: string; }) => void) | (({ promotionShown }: { promotionShown: boolean; }) => void) | (({ payoutId }: { payoutId: string; }) => void) | undefined>(component: T | null, value: V, onUpdated: (component: T, value: V) => void) => void; export { CommonComponentProps, ConnectPayments, ConnectPayouts, ConnectPaymentDetails, ConnectPaymentDisputes, ConnectDisputesList, CollectionOptions, ConnectAccountOnboarding, ConnectAccountManagement, ConnectNotificationBanner, ConnectIssuingCard, ConnectIssuingCardsList, ConnectFinancialAccount, ConnectFinancialAccountTransactions, ConnectDocuments, ConnectPayoutsList, ConnectBalances, ConnectTaxRegistrations, ConnectTaxSettings, ConnectInstantPayoutsPromotion, ConnectComponentsProvider, useConnectComponents, useCreateComponent, useAttachAttribute, ConnectElementEventNames, useAttachEvent, useUpdateWithSetter };