@funnelfox/billing 0.9.0 → 0.9.2

package/src/types.d.ts

@@ -93,16 +93,20 @@ export interface CheckoutConfig extends PrimerCheckoutConfig {
   enableTax?: boolean;
   onTaxChange?: (info: TaxInfo) => void;
   onTaxError?: (error: Error) => void;
+  onTaxPending?: () => void;
 }
 
 export interface TaxInfo {
   /** Minor units; the total the customer pays. */
   amountTotal: number;
-  /** Minor units; tax ADDED on top of the price — 0 for tax-inclusive pricing and non-taxed locations. */
+  /** Minor units; the tax to show the buyer — added on top when exclusive, already inside the price when inclusive, 0 when unknown. */
   taxAmount: number;
   currency: string;
+  taxBehavior?: TaxBehavior;
 }
 
+export type TaxBehavior = 'inclusive' | 'exclusive';
+
 export interface PaymentButtonSelectors {
   paypal: string;
   googlePay: string;
@@ -375,6 +379,9 @@ export interface InitMethodCallbacks {
   onLoaderChange?: (state: boolean) => void;
   onPaymentStarted?: (method: PaymentMethod) => void;
   onMethodsAvailable?: (methods: PaymentMethod[]) => void;
+  onTaxChange?: (info: TaxInfo) => void;
+  onTaxError?: (error: Error) => void;
+  onTaxPending?: () => void;
 }
 
 export declare function initMethod(
@@ -400,7 +407,7 @@ export declare function getAvailablePaymentMethods(params: {
 export interface StripeCardFormOptions
   extends
     CreateClientSessionOptions,
-    Omit<InitMethodCallbacks, 'onPaymentSuccess'> {
+    Omit<InitMethodCallbacks, 'onPaymentSuccess' | 'onTaxPending'> {
   onPaymentSuccess?: (
     paymentMethod: import('@stripe/stripe-js').PaymentMethod,
     orderId: string
@@ -417,12 +424,16 @@ export interface StripeCardFormOptions
 export interface StripeWalletOptions
   extends
     CreateClientSessionOptions,
-    Omit<InitMethodCallbacks, 'onPaymentSuccess'> {
+    Omit<
+      InitMethodCallbacks,
+      'onPaymentSuccess' | 'onTaxPending' | 'onTaxError'
+    > {
   onPaymentSuccess?: (
     paymentMethod: import('@stripe/stripe-js').PaymentMethod,
     orderId: string
   ) => void;
   totalLabel?: string;
+  onTaxChange?: (info: TaxInfo) => void;
 }
 
 export interface StripeCardForm {
@@ -536,6 +547,8 @@ export interface CreateClientSessionResponse {
     // Session tax estimate (detected-country) in minor units — for showing tax on mount and in the
     // wallet sheet, and (Stripe-direct) collecting it via the wallet.
     tax_amount?: number;
+    tax_inclusive_amount?: number;
+    tax_behavior?: TaxBehavior;
     amount_total?: number;
     currency?: string;
     tax_calculation_id?: string;
@@ -563,6 +576,8 @@ export interface TaxRecalculationData {
   tax_calculation_id: string;
   amount_total: number;
   tax_amount: number;
+  tax_inclusive_amount?: number;
+  tax_behavior?: TaxBehavior;
   currency: string;
 }