[SDK] Add enableCard prop to control fiat payment visibility

Adds enableCard prop to BuyWidget, CheckoutWidget, and TransactionWidget components to allow hiding the "Buy with card" fiat payment option.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: gregfromstl

.changeset/dull-breads-start.md

@@ -0,0 +1,5 @@
+---
+"thirdweb": patch
+---
+
+Adds enableCard prop to BuyWidget, CheckoutWidget, and TransactionWidget

packages/thirdweb/src/react/web/ui/Bridge/BridgeOrchestrator.tsx

@@ -113,6 +113,11 @@ export interface BridgeOrchestratorProps {
    * Quick buy amounts
    */
   presetOptions: [number, number, number] | undefined;
+
+  /**
+   * Whether to enable the "Buy with card" (fiat payment) option
+   */
+  enableCard?: boolean;
 }
 
 export function BridgeOrchestrator({
@@ -127,6 +132,7 @@ export function BridgeOrchestrator({
   purchaseData,
   paymentLinkId,
   presetOptions,
+  enableCard,
 }: BridgeOrchestratorProps) {
   // Initialize adapters
   const adapters = useMemo(
@@ -271,6 +277,7 @@ export function BridgeOrchestrator({
             onError={handleError}
             onPaymentMethodSelected={handlePaymentMethodSelected}
             receiverAddress={state.context.receiverAddress}
+            enableCard={enableCard}
           />
         )}
 

packages/thirdweb/src/react/web/ui/Bridge/BuyWidget.tsx

@@ -160,6 +160,12 @@ export type BuyWidgetProps = {
    * @hidden
    */
   paymentLinkId?: string;
+
+  /**
+   * Whether to enable the "Buy with card" (fiat payment) option.
+   * @default true
+   */
+  enableCard?: boolean;
 };
 
 // Enhanced UIOptions to handle unsupported token state
@@ -382,6 +388,7 @@ export function BuyWidget(props: BuyWidgetProps) {
         purchaseData={props.purchaseData}
         receiverAddress={undefined}
         uiOptions={bridgeDataQuery.data.data}
+        enableCard={props.enableCard}
       />
     );
   }

packages/thirdweb/src/react/web/ui/Bridge/CheckoutWidget.tsx

@@ -166,6 +166,12 @@ export type CheckoutWidgetProps = {
    * @hidden
    */
   paymentLinkId?: string;
+
+  /**
+   * Whether to enable the "Buy with card" (fiat payment) option.
+   * @default true
+   */
+  enableCard?: boolean;
 };
 
 // Enhanced UIOptions to handle unsupported token state
@@ -345,6 +351,7 @@ export function CheckoutWidget(props: CheckoutWidgetProps) {
         purchaseData={props.purchaseData}
         receiverAddress={props.seller}
         uiOptions={bridgeDataQuery.data.data}
+        enableCard={props.enableCard}
       />
     );
   }

packages/thirdweb/src/react/web/ui/Bridge/TransactionWidget.tsx

@@ -169,6 +169,12 @@ export type TransactionWidgetProps = {
    * @hidden
    */
   paymentLinkId?: string;
+
+  /**
+   * Whether to enable the "Buy with card" (fiat payment) option.
+   * @default true
+   */
+  enableCard?: boolean;
 };
 
 // Enhanced UIOptions to handle unsupported token state
@@ -404,6 +410,7 @@ export function TransactionWidget(props: TransactionWidgetProps) {
         purchaseData={props.purchaseData}
         receiverAddress={undefined}
         uiOptions={bridgeDataQuery.data.data}
+        enableCard={props.enableCard}
       />
     );
   }

packages/thirdweb/src/react/web/ui/Bridge/payment-selection/PaymentSelection.tsx

@@ -71,6 +71,11 @@ export interface PaymentSelectionProps {
    * Whether to include the destination token in the payment methods
    */
   includeDestinationToken?: boolean;
+
+  /**
+   * Whether to enable the "Buy with card" (fiat payment) option
+   */
+  enableCard?: boolean;
 }
 
 type Step =
@@ -90,6 +95,7 @@ export function PaymentSelection({
   connectOptions,
   connectLocale,
   includeDestinationToken,
+  enableCard,
 }: PaymentSelectionProps) {
   const connectedWallets = useConnectedWallets();
   const activeWallet = useActiveWallet();
@@ -248,6 +254,7 @@ export function PaymentSelection({
             onConnectWallet={handleConnectWallet}
             onFiatSelected={handleFiatSelected}
             onWalletSelected={handleWalletSelected}
+            enableCard={enableCard}
           />
         )}
 

packages/thirdweb/src/react/web/ui/Bridge/payment-selection/WalletFiatSelection.tsx

@@ -21,6 +21,7 @@ interface WalletFiatSelectionProps {
   onWalletSelected: (wallet: Wallet) => void;
   onFiatSelected: () => void;
   onConnectWallet: () => void;
+  enableCard?: boolean;
 }
 
 export function WalletFiatSelection({
@@ -29,6 +30,7 @@ export function WalletFiatSelection({
   onWalletSelected,
   onFiatSelected,
   onConnectWallet,
+  enableCard = true,
 }: WalletFiatSelectionProps) {
   const theme = useCustomTheme();
 
@@ -126,47 +128,50 @@ export function WalletFiatSelection({
         </Container>
       </Button>
 
-      <Spacer y="md" />
+      {enableCard && (
+        <>
+          <Spacer y="md" />
 
-      {/* Pay with Debit Card */}
-      <Text color="primaryText" size="md">
-        Pay with Fiat
-      </Text>
+          <Text color="primaryText" size="md">
+            Pay with Card
+          </Text>
 
-      <Spacer y="md" />
+          <Spacer y="md" />
 
-      <Button
-        fullWidth
-        onClick={onFiatSelected}
-        style={{
-          backgroundColor: theme.colors.tertiaryBg,
-          border: `1px solid ${theme.colors.borderColor}`,
-          borderRadius: radius.md,
-          height: "auto",
-          padding: `${spacing.sm} ${spacing.md}`,
-          textAlign: "left",
-        }}
-        variant="secondary"
-      >
-        <Container
-          flex="row"
-          gap="md"
-          style={{ alignItems: "center", width: "100%" }}
-        >
-          <CreditCardIcon
-            color={theme.colors.secondaryIconColor}
-            size={iconSize.lg}
-          />
-          <Container flex="column" gap="3xs" style={{ flex: 1 }}>
-            <Text color="primaryText" size="sm" style={{ fontWeight: 600 }}>
-              Pay with Card
-            </Text>
-            <Text color="secondaryText" size="xs">
-              Buy crypto and bridge in one step
-            </Text>
-          </Container>
-        </Container>
-      </Button>
+          <Button
+            fullWidth
+            onClick={onFiatSelected}
+            style={{
+              backgroundColor: theme.colors.tertiaryBg,
+              border: `1px solid ${theme.colors.borderColor}`,
+              borderRadius: radius.md,
+              height: "auto",
+              padding: `${spacing.sm} ${spacing.md}`,
+              textAlign: "left",
+            }}
+            variant="secondary"
+          >
+            <Container
+              flex="row"
+              gap="md"
+              style={{ alignItems: "center", width: "100%" }}
+            >
+              <CreditCardIcon
+                color={theme.colors.secondaryIconColor}
+                size={iconSize.lg}
+              />
+              <Container flex="column" gap="3xs" style={{ flex: 1 }}>
+                <Text color="primaryText" size="sm" style={{ fontWeight: 600 }}>
+                  Pay with Card
+                </Text>
+                <Text color="secondaryText" size="xs">
+                  Buy crypto and bridge in one step
+                </Text>
+              </Container>
+            </Container>
+          </Button>
+        </>
+      )}
     </>
   );
 }

packages/thirdweb/src/react/web/ui/PayEmbed.tsx

@@ -359,6 +359,7 @@ export function PayEmbed(props: PayEmbedProps) {
         onSuccess={() => props.payOptions?.onPurchaseSuccess?.()}
         theme={theme}
         title={metadata?.name || "Buy"}
+        enableCard={props.payOptions?.buyWithFiat === false ? false : true}
         tokenAddress={
           props.payOptions.prefillBuy.token?.address as Address | undefined
         }
@@ -377,6 +378,7 @@ export function PayEmbed(props: PayEmbedProps) {
         name={metadata?.name || "Checkout"}
         onSuccess={() => props.payOptions?.onPurchaseSuccess?.()}
         seller={props.payOptions.paymentInfo.sellerAddress as Address}
+        enableCard={props.payOptions?.buyWithFiat === false ? false : true}
         theme={theme}
         tokenAddress={
           props.payOptions.paymentInfo.token?.address as Address | undefined
@@ -393,6 +395,7 @@ export function PayEmbed(props: PayEmbedProps) {
         image={metadata?.image}
         onSuccess={() => props.payOptions?.onPurchaseSuccess?.()}
         theme={theme}
+        enableCard={props.payOptions?.buyWithFiat === false ? false : true}
         title={metadata?.name}
         transaction={props.payOptions.transaction}
       />
@@ -513,10 +516,10 @@ export type PayEmbedConnectOptions = {
    * ```
    */
   autoConnect?:
-    | {
-        timeout: number;
-      }
-    | boolean;
+  | {
+    timeout: number;
+  }
+  | boolean;
 
   /**
    * Metadata of the app that will be passed to connected wallet. Setting this is highly recommended.