Wallets reference

overflow.applePay(options?: ApplePayElementOptions): ApplePayElement
overflow.googlePay(options?: GooglePayElementOptions): GooglePayElement

type WalletTransactionOptions = {
  amount?: number;              // minor units (e.g. cents)
  currency?: string;            // ISO 4217, e.g. 'USD'
  countryCode?: string;         // ISO 3166-1 alpha-2, e.g. 'US'
  label?: string;               // shown above the total in the sheet
  lineItems?: { label: string; amount: number }[];
};

type WalletRequireOptions = {
  name?: boolean;             // default false
  email?: boolean;            // default false
  phone?: boolean;            // default false
  billingAddress?: boolean;   // default false
  shippingAddress?: boolean;  // default false
};

type ApplePayRequirementOptions = {
  shippingMethods?: unknown[];                    // passed through verbatim
  requiredBillingContactFields?: unknown[];        // replaces derived array
  requiredShippingContactFields?: unknown[];       // replaces derived array
};

type GooglePayRequirementOptions = {
  billingAddressParameters?: BillingAddressParameters;   // merged on top of derived params
  shippingAddressParameters?: ShippingAddressParameters; // passed through verbatim
  shippingOptionRequired?: boolean;
};

type WalletElementValue = {
  walletToken: string;
  walletType: 'applePay' | 'googlePay';
  email?: string;
  name?: FullNameValue;
  phone?: string; // raw string as returned by the wallet sheet — not the contact-element phone shape
  billingAddress?: AddressValue;
  shippingAddress?: AddressValue;
};

type FullNameValue = { firstName: string; lastName: string };

type AddressValue = {
  line1: string;
  line2?: string;
  city: string;
  state: string;
  zip: string;
  country: string;
};

apple.on('onClick', (event) => {
  event.preventDefault();
  if (!ready) {
    event.reject(new Error('not_ready'));
    return;
  }
  event.resolve();
});