Add providerOverride as an option for fiat payments

Author: edwardysun

packages/thirdweb/src/pay/buyWithFiat/getQuote.ts

@@ -91,6 +91,14 @@ export type GetBuyWithFiatQuoteParams = {
    * By default, we choose a recommended provider based on the location of the user, KYC status, and currency.
    */
   preferredProvider?: FiatProvider;
+
+    /**
+   * Optional parameter to specify an overriding onramp provider.
+   *
+   * By default, we choose a recommended provider based on the location of the user, KYC status, and currency.
+   * If this is set, we will always choose this specific onramp provider, or error if this provider cannot support the user.
+   */
+  providerOverride?: FiatProvider;
 };
 
 /**
@@ -313,6 +321,7 @@ export async function getBuyWithFiatQuote(
         fromAddress: params.fromAddress,
         toGasAmountWei: params.toGasAmountWei,
         preferredProvider: params.preferredProvider,
+        providerOverride: params.providerOverride,
       }),
     });
 

packages/thirdweb/src/react/core/hooks/connection/ConnectButtonProps.ts

@@ -91,6 +91,7 @@ export type PayUIOptions = Prettify<
             currency?: "USD" | "CAD" | "GBP" | "EUR" | "JPY";
           };
           preferredProvider?: FiatProvider;
+          providerOverride?: FiatProvider;
         }
       | false;
 

packages/thirdweb/src/react/core/hooks/transaction/useSendTransaction.ts

@@ -61,6 +61,7 @@ export type SendTransactionPayModalConfig =
             };
             testMode?: boolean;
             preferredProvider?: FiatProvider;
+            providerOverride?: FiatProvider;
           };
       purchaseData?: object;
       /**

packages/thirdweb/src/react/web/ui/ConnectWallet/screens/Buy/BuyScreen.tsx

@@ -1247,6 +1247,7 @@ function FiatScreenContent(props: {
           purchaseData: props.payOptions.purchaseData,
           fromAddress: payer.account.address,
           preferredProvider: buyWithFiatOptions?.preferredProvider,
+          providerOverride: buyWithFiatOptions?.providerOverride,
         }
       : undefined,
   );