@funnelfox/billing 0.9.3-ffb-apple-pay-continue-button.33 → 0.10.1

package/src/types.d.ts

@@ -74,40 +74,10 @@ export interface BillingCardOptions extends CheckoutCardOptions {
   emailAddress?: BillingCardEmailAddressOptions;
 }
 
-/**
- * Apple Pay button types (https://developer.apple.com/documentation/applepayontheweb/applepaybuttontype).
- *
- * The legacy 7 values (Primer's union) render through Primer's CSS approach.
- * The newer values (e.g. 'continue') cannot be rendered by WebKit via CSS, so
- * the SDK overlays Apple's official <apple-pay-button> element on top of the
- * Primer button and forwards clicks (see utils/apple-pay-native-button.ts,
- * PRD-1426). Payment flow stays fully Primer-driven either way.
- */
-export type ApplePayButtonType =
-  | NonNullable<ApplePayOptions['buttonType']>
-  | 'add-money'
-  | 'continue'
-  | 'contribute'
-  | 'order'
-  | 'pay'
-  | 'reload'
-  | 'rent'
-  | 'support'
-  | 'tip'
-  | 'top-up';
-
-export type BillingApplePayOptions = Omit<
-  ApplePayOptions,
-  'container' | 'buttonType'
-> & {
-  buttonType?: ApplePayButtonType;
-};
-
 export interface PrimerCheckoutConfig extends Pick<
   Partial<HeadlessUniversalCheckoutOptions>,
-  'paypal' | 'googlePay' | 'style'
+  'paypal' | 'applePay' | 'googlePay' | 'style'
 > {
-  applePay?: BillingApplePayOptions;
   card?: BillingCardOptions;
   cardSelectors?: CardInputSelectors;
   paymentButtonSelectors?: PaymentButtonSelectors;
@@ -123,14 +93,40 @@ 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;
+  taxRate?: number;
+  taxBreakdown?: TaxBreakdownEntry[];
+}
+
+export type TaxBehavior = 'inclusive' | 'exclusive';
+
+export interface TaxBreakdownEntry {
+  amount: string;
+  percentage: string;
+  inclusive: boolean;
+  taxType?: string | null;
+  country?: string | null;
+  subdivision?: string | null;
+  taxabilityReason?: string | null;
+}
+
+export interface TaxBreakdownEntryResponse {
+  amount: string;
+  percentage: string;
+  inclusive: boolean;
+  tax_type?: string | null;
+  country?: string | null;
+  subdivision?: string | null;
+  taxability_reason?: string | null;
 }
 
 export interface PaymentButtonSelectors {
@@ -139,11 +135,7 @@ export interface PaymentButtonSelectors {
   applePay: string;
 }
 
-export interface CheckoutOptions extends Omit<
-  Partial<HeadlessUniversalCheckoutOptions>,
-  'applePay'
-> {
-  applePay?: BillingApplePayOptions;
+export interface CheckoutOptions extends Partial<HeadlessUniversalCheckoutOptions> {
   onTokenizeSuccess: OnTokenizeSuccess;
   onResumeSuccess: OnResumeSuccess;
   onAvailablePaymentMethodsLoad?: (items: PaymentMethod[]) => void;
@@ -298,6 +290,8 @@ export interface APIError extends FunnefoxSDKError {
   errorType: string | null;
   requestId: string | null;
   response: unknown;
+  declineCode: string | null;
+  declineCodeSource: DeclineCodeSource | null;
 }
 
 export interface PrimerError extends FunnefoxSDKError {
@@ -384,13 +378,12 @@ export interface InitMethodOptions
       Partial<
         Pick<
           HeadlessUniversalCheckoutOptions,
-          'style' | 'card' | 'paypal' | 'googlePay'
+          'style' | 'card' | 'applePay' | 'paypal' | 'googlePay'
         >
       >,
       'card'
     >,
     InitMethodCallbacks {
-  applePay?: BillingApplePayOptions;
   card?: BillingCardOptions;
   orgId: string;
   baseUrl?: string;
@@ -400,16 +393,26 @@ export interface InitMethodOptions
   meta?: MetadataType;
 }
 
+export type DeclineCodeSource = ('primer' | 'stripe' | 'adyen') | (string & {});
+
+export type PaymentFailure = Error & {
+  declineCode?: string | null;
+  declineCodeSource?: DeclineCodeSource | null;
+};
+
 export interface InitMethodCallbacks {
   onRenderSuccess?: () => void;
   onRenderError?: (err: PaymentMethod) => void;
   onPaymentSuccess?: () => void;
-  onPaymentFail?: (err: Error) => void;
+  onPaymentFail?: (err: PaymentFailure) => void;
   onPaymentCancel?: () => void;
   onErrorMessageChange?: (msg: string) => void;
   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(
@@ -435,7 +438,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
@@ -452,12 +455,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 {
@@ -571,6 +578,9 @@ 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;
+    tax_breakdown?: TaxBreakdownEntryResponse[];
     amount_total?: number;
     currency?: string;
     tax_calculation_id?: string;
@@ -598,6 +608,9 @@ export interface TaxRecalculationData {
   tax_calculation_id: string;
   amount_total: number;
   tax_amount: number;
+  tax_inclusive_amount?: number;
+  tax_behavior?: TaxBehavior;
+  tax_breakdown?: TaxBreakdownEntryResponse[];
   currency: string;
 }
 
@@ -616,6 +629,8 @@ export interface PaymentResponseData {
   action_required_token: string;
   checkout_status: 'processing' | 'succeeded' | 'failed' | 'cancelled';
   failed_message_for_user: string;
+  decline_code?: string | null;
+  decline_code_source?: DeclineCodeSource | null;
   order_id: string;
 }