@capgo/capacitor-pay 8.0.12 → 8.1.0

package/dist/esm/definitions.d.ts

@@ -1,5 +1,5 @@
 export type PayPlatform = 'ios' | 'android' | 'web';
-export type ApplePayNetwork = 'AmEx' | 'Bancomat' | 'Bancontact' | 'PagoBancomat' | 'CarteBancaire' | 'CarteBancaires' | 'CartesBancaires' | 'ChinaUnionPay' | 'Dankort' | 'Discover' | 'Eftpos' | 'Electron' | 'Elo' | 'girocard' | 'Himyan' | 'Interac' | 'iD' | 'Jaywan' | 'JCB' | 'mada' | 'Maestro' | 'MasterCard' | 'Meeza' | 'Mir' | 'MyDebit' | 'NAPAS' | 'BankAxept' | 'PostFinanceAG' | 'PrivateLabel' | 'QUICPay' | 'Suica' | 'Visa' | 'VPay';
+export type ApplePayNetwork = 'AmEx' | 'amex' | 'Bancomat' | 'Bancontact' | 'PagoBancomat' | 'CarteBancaire' | 'CarteBancaires' | 'CartesBancaires' | 'ChinaUnionPay' | 'Dankort' | 'Discover' | 'discover' | 'Eftpos' | 'Electron' | 'Elo' | 'girocard' | 'Himyan' | 'Interac' | 'iD' | 'Jaywan' | 'JCB' | 'jcb' | 'mada' | 'Maestro' | 'maestro' | 'MasterCard' | 'masterCard' | 'Meeza' | 'Mir' | 'MyDebit' | 'NAPAS' | 'BankAxept' | 'PostFinanceAG' | 'PrivateLabel' | 'QUICPay' | 'Suica' | 'Visa' | 'visa' | 'VPay' | 'vPay';
 export type ApplePayMerchantCapability = '3DS' | 'credit' | 'debit' | 'emv';
 export type ApplePaySummaryItemType = 'final' | 'pending';
 export type ApplePayContactField = 'emailAddress' | 'name' | 'phoneNumber' | 'postalAddress';
@@ -9,6 +9,61 @@ export interface ApplePaySummaryItem {
     amount: string;
     type?: ApplePaySummaryItemType;
 }
+export type ApplePayRecurringPaymentIntervalUnit = 'day' | 'week' | 'month' | 'year';
+export interface ApplePayRecurringPaymentSummaryItem extends ApplePaySummaryItem {
+    /**
+     * Unit of time between recurring payments.
+     */
+    intervalUnit: ApplePayRecurringPaymentIntervalUnit;
+    /**
+     * Number of `intervalUnit` units between recurring payments (for example `1` month, `2` weeks).
+     */
+    intervalCount: number;
+    /**
+     * Start date of the recurring period.
+     *
+     * On supported platforms this may be either:
+     * - a `number` representing milliseconds since Unix epoch, or
+     * - a `string` in a date format accepted by the native implementation
+     *   (for example an ISO 8601 date-time string or a `yyyy-MM-dd` date string).
+     */
+    startDate?: number | string;
+    /**
+     * End date of the recurring period.
+     *
+     * On supported platforms this may be either:
+     * - a `number` representing milliseconds since Unix epoch, or
+     * - a `string` in a date format accepted by the native implementation
+     *   (for example an ISO 8601 date-time string or a `yyyy-MM-dd` date string).
+     */
+    endDate?: number | string;
+}
+export interface ApplePayRecurringPaymentRequest {
+    /**
+     * A description for the recurring payment shown in the Apple Pay sheet.
+     */
+    paymentDescription: string;
+    /**
+     * The recurring billing item (for example your subscription).
+     */
+    regularBilling: ApplePayRecurringPaymentSummaryItem;
+    /**
+     * URL where the user can manage the recurring payment (cancel, update, etc).
+     */
+    managementURL: string;
+    /**
+     * Optional billing agreement text shown to the user.
+     */
+    billingAgreement?: string;
+    /**
+     * Optional URL where Apple can send token update notifications.
+     */
+    tokenNotificationURL?: string;
+    /**
+     * Optional trial billing item (for example a free trial period).
+     */
+    trialBilling?: ApplePayRecurringPaymentSummaryItem;
+}
 export interface ApplePayAvailabilityOptions {
     /**
      * Optional list of payment networks you intend to use.
@@ -71,6 +126,10 @@ export interface ApplePayPaymentOptions {
      * Optional opaque application data passed back in the payment token.
      */
     applicationData?: string;
+    /**
+     * Recurring payment configuration (iOS 16+).
+     */
+    recurringPaymentRequest?: ApplePayRecurringPaymentRequest;
 }
 export interface ApplePayContact {
     name?: {
@@ -116,6 +175,82 @@ export interface ApplePayPaymentResult {
     billingContact?: ApplePayContact;
 }
 export type GooglePayEnvironment = 'test' | 'production';
+export type GooglePayCardNetwork = 'AMEX' | 'DISCOVER' | 'JCB' | 'MASTERCARD' | 'VISA' | (string & Record<never, never>);
+export type GooglePayAuthMethod = 'PAN_ONLY' | 'CRYPTOGRAM_3DS' | (string & Record<never, never>);
+export type GooglePayTotalPriceStatus = 'NOT_CURRENTLY_KNOWN' | 'ESTIMATED' | 'FINAL' | (string & Record<never, never>);
+export interface GooglePayBillingAddressParameters {
+    format?: 'MIN' | 'FULL' | (string & Record<never, never>);
+    phoneNumberRequired?: boolean;
+}
+export interface GooglePayCardPaymentMethodParameters {
+    allowedAuthMethods?: GooglePayAuthMethod[];
+    allowedCardNetworks?: GooglePayCardNetwork[];
+    billingAddressRequired?: boolean;
+    billingAddressParameters?: GooglePayBillingAddressParameters;
+}
+export interface GooglePayTokenizationSpecification {
+    type?: 'PAYMENT_GATEWAY' | 'DIRECT' | (string & Record<never, never>);
+    parameters?: Record<string, string>;
+}
+export interface GooglePayAllowedPaymentMethod {
+    type?: 'CARD' | (string & Record<never, never>);
+    parameters?: GooglePayCardPaymentMethodParameters;
+    tokenizationSpecification?: GooglePayTokenizationSpecification;
+}
+export interface GooglePayMerchantInfo {
+    merchantId?: string;
+    merchantName?: string;
+}
+export interface GooglePayTransactionInfo {
+    totalPriceStatus?: GooglePayTotalPriceStatus;
+    totalPrice?: string;
+    currencyCode?: string;
+    countryCode?: string;
+}
+/**
+ * Typed helper for the Google Pay `IsReadyToPayRequest` JSON.
+ * The native Android implementation still accepts arbitrary JSON (forward compatible).
+ */
+export interface GooglePayIsReadyToPayRequest {
+    /**
+     * The list of payment methods you want to check for readiness.
+     */
+    allowedPaymentMethods?: GooglePayAllowedPaymentMethod[];
+    /**
+     * Forward-compatible escape hatch for additional fields supported by Google Pay.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Typed helper for the Google Pay `PaymentDataRequest` JSON.
+ * The native Android implementation still accepts arbitrary JSON (forward compatible).
+ */
+export interface GooglePayPaymentDataRequest {
+    /**
+     * Google Pay API version, typically `2`.
+     */
+    apiVersion?: number;
+    /**
+     * Google Pay API minor version, typically `0`.
+     */
+    apiVersionMinor?: number;
+    /**
+     * Allowed payment method configurations.
+     */
+    allowedPaymentMethods?: GooglePayAllowedPaymentMethod[];
+    /**
+     * Merchant information displayed in the Google Pay sheet.
+     */
+    merchantInfo?: GooglePayMerchantInfo;
+    /**
+     * Transaction details (amount, currency, etc).
+     */
+    transactionInfo?: GooglePayTransactionInfo;
+    /**
+     * Forward-compatible escape hatch for additional fields supported by Google Pay.
+     */
+    [key: string]: unknown;
+}
 export interface GooglePayAvailabilityOptions {
     /**
      * Environment used to construct the Google Payments client. Defaults to `'test'`.
@@ -125,7 +260,7 @@ export interface GooglePayAvailabilityOptions {
      * Raw `IsReadyToPayRequest` JSON as defined by the Google Pay API.
      * Supply the card networks and auth methods you intend to support at runtime.
      */
-    isReadyToPayRequest?: Record<string, unknown>;
+    isReadyToPayRequest?: GooglePayIsReadyToPayRequest;
 }
 export interface GooglePayAvailabilityResult {
     /**
@@ -142,7 +277,7 @@ export interface GooglePayPaymentOptions {
      * Raw `PaymentDataRequest` JSON as defined by the Google Pay API.
      * Provide transaction details, merchant info, and tokenization parameters.
      */
-    paymentDataRequest: Record<string, unknown>;
+    paymentDataRequest: GooglePayPaymentDataRequest;
 }
 export interface GooglePayPaymentResult {
     /**

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export type PayPlatform = 'ios' | 'android' | 'web';\n\nexport type ApplePayNetwork =\n  | 'AmEx'\n  | 'Bancomat'\n  | 'Bancontact'\n  | 'PagoBancomat'\n  | 'CarteBancaire'\n  | 'CarteBancaires'\n  | 'CartesBancaires'\n  | 'ChinaUnionPay'\n  | 'Dankort'\n  | 'Discover'\n  | 'Eftpos'\n  | 'Electron'\n  | 'Elo'\n  | 'girocard'\n  | 'Himyan'\n  | 'Interac'\n  | 'iD'\n  | 'Jaywan'\n  | 'JCB'\n  | 'mada'\n  | 'Maestro'\n  | 'MasterCard'\n  | 'Meeza'\n  | 'Mir'\n  | 'MyDebit'\n  | 'NAPAS'\n  | 'BankAxept'\n  | 'PostFinanceAG'\n  | 'PrivateLabel'\n  | 'QUICPay'\n  | 'Suica'\n  | 'Visa'\n  | 'VPay';\n\nexport type ApplePayMerchantCapability = '3DS' | 'credit' | 'debit' | 'emv';\n\nexport type ApplePaySummaryItemType = 'final' | 'pending';\n\nexport type ApplePayContactField = 'emailAddress' | 'name' | 'phoneNumber' | 'postalAddress';\n\nexport type ApplePayShippingType = 'shipping' | 'delivery' | 'servicePickup' | 'storePickup';\n\nexport interface ApplePaySummaryItem {\n  label: string;\n  amount: string;\n  type?: ApplePaySummaryItemType;\n}\n\nexport interface ApplePayAvailabilityOptions {\n  /**\n   * Optional list of payment networks you intend to use.\n   * Passing networks determines the return value of `canMakePaymentsUsingNetworks`.\n   */\n  supportedNetworks?: ApplePayNetwork[];\n}\n\nexport interface ApplePayAvailabilityResult {\n  /**\n   * Indicates whether the device can make Apple Pay payments in general.\n   */\n  canMakePayments: boolean;\n  /**\n   * Indicates whether the device can make Apple Pay payments with the supplied networks.\n   */\n  canMakePaymentsUsingNetworks: boolean;\n}\n\nexport interface ApplePayPaymentOptions {\n  /**\n   * Merchant identifier created in the Apple Developer portal.\n   */\n  merchantIdentifier: string;\n  /**\n   * Two-letter ISO 3166 country code.\n   */\n  countryCode: string;\n  /**\n   * Three-letter ISO 4217 currency code.\n   */\n  currencyCode: string;\n  /**\n   * Payment summary items displayed in the Apple Pay sheet.\n   */\n  paymentSummaryItems: ApplePaySummaryItem[];\n  /**\n   * Card networks to support.\n   */\n  supportedNetworks: ApplePayNetwork[];\n  /**\n   * Merchant payment capabilities. Defaults to ['3DS'] when omitted.\n   */\n  merchantCapabilities?: ApplePayMerchantCapability[];\n  /**\n   * Contact fields that must be supplied for shipping.\n   */\n  requiredShippingContactFields?: ApplePayContactField[];\n  /**\n   * Contact fields that must be supplied for billing.\n   */\n  requiredBillingContactFields?: ApplePayContactField[];\n  /**\n   * Controls the shipping flow presented to the user.\n   */\n  shippingType?: ApplePayShippingType;\n  /**\n   * Optional ISO 3166 country codes where the merchant is supported.\n   */\n  supportedCountries?: string[];\n  /**\n   * Optional opaque application data passed back in the payment token.\n   */\n  applicationData?: string;\n}\n\nexport interface ApplePayContact {\n  name?: {\n    givenName?: string;\n    familyName?: string;\n    middleName?: string;\n    namePrefix?: string;\n    nameSuffix?: string;\n    nickname?: string;\n  };\n  emailAddress?: string;\n  phoneNumber?: string;\n  postalAddress?: {\n    street?: string;\n    city?: string;\n    state?: string;\n    postalCode?: string;\n    country?: string;\n    isoCountryCode?: string;\n    subAdministrativeArea?: string;\n    subLocality?: string;\n  };\n}\n\nexport interface ApplePayPaymentResult {\n  /**\n   * Raw payment token encoded as base64 string.\n   */\n  paymentData: string;\n  /**\n   * Raw payment token JSON string, useful for debugging.\n   */\n  paymentString: string;\n  /**\n   * Payment transaction identifier.\n   */\n  transactionIdentifier: string;\n  paymentMethod: {\n    displayName?: string;\n    network?: ApplePayNetwork;\n    type: 'debit' | 'credit' | 'prepaid' | 'store';\n  };\n  shippingContact?: ApplePayContact;\n  billingContact?: ApplePayContact;\n}\n\nexport type GooglePayEnvironment = 'test' | 'production';\n\nexport interface GooglePayAvailabilityOptions {\n  /**\n   * Environment used to construct the Google Payments client. Defaults to `'test'`.\n   */\n  environment?: GooglePayEnvironment;\n  /**\n   * Raw `IsReadyToPayRequest` JSON as defined by the Google Pay API.\n   * Supply the card networks and auth methods you intend to support at runtime.\n   */\n  isReadyToPayRequest?: Record<string, unknown>;\n}\n\nexport interface GooglePayAvailabilityResult {\n  /**\n   * Indicates whether the Google Pay API is available for the supplied parameters.\n   */\n  isReady: boolean;\n}\n\nexport interface GooglePayPaymentOptions {\n  /**\n   * Environment used to construct the Google Payments client. Defaults to `'test'`.\n   */\n  environment?: GooglePayEnvironment;\n  /**\n   * Raw `PaymentDataRequest` JSON as defined by the Google Pay API.\n   * Provide transaction details, merchant info, and tokenization parameters.\n   */\n  paymentDataRequest: Record<string, unknown>;\n}\n\nexport interface GooglePayPaymentResult {\n  /**\n   * Payment data returned by Google Pay.\n   */\n  paymentData: Record<string, unknown>;\n}\n\nexport interface PayAvailabilityOptions {\n  apple?: ApplePayAvailabilityOptions;\n  google?: GooglePayAvailabilityOptions;\n}\n\nexport interface PayAvailabilityResult {\n  available: boolean;\n  platform: PayPlatform;\n  apple?: ApplePayAvailabilityResult;\n  google?: GooglePayAvailabilityResult;\n}\n\nexport interface PayPaymentOptions {\n  apple?: ApplePayPaymentOptions;\n  google?: GooglePayPaymentOptions;\n}\n\nexport interface PayPaymentResult {\n  platform: Exclude<PayPlatform, 'web'>;\n  apple?: ApplePayPaymentResult;\n  google?: GooglePayPaymentResult;\n}\n\nexport interface PayPlugin {\n  /**\n   * Checks whether native pay is available on the current platform.\n   * On iOS this evaluates Apple Pay, on Android it evaluates Google Pay.\n   */\n  isPayAvailable(options?: PayAvailabilityOptions): Promise<PayAvailabilityResult>;\n  /**\n   * Presents the native pay sheet for the current platform.\n   * Provide the Apple Pay configuration on iOS and the Google Pay configuration on Android.\n   */\n  requestPayment(options: PayPaymentOptions): Promise<PayPaymentResult>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export type PayPlatform = 'ios' | 'android' | 'web';\n\nexport type ApplePayNetwork =\n  | 'AmEx'\n  | 'amex'\n  | 'Bancomat'\n  | 'Bancontact'\n  | 'PagoBancomat'\n  | 'CarteBancaire'\n  | 'CarteBancaires'\n  | 'CartesBancaires'\n  | 'ChinaUnionPay'\n  | 'Dankort'\n  | 'Discover'\n  | 'discover'\n  | 'Eftpos'\n  | 'Electron'\n  | 'Elo'\n  | 'girocard'\n  | 'Himyan'\n  | 'Interac'\n  | 'iD'\n  | 'Jaywan'\n  | 'JCB'\n  | 'jcb'\n  | 'mada'\n  | 'Maestro'\n  | 'maestro'\n  | 'MasterCard'\n  | 'masterCard'\n  | 'Meeza'\n  | 'Mir'\n  | 'MyDebit'\n  | 'NAPAS'\n  | 'BankAxept'\n  | 'PostFinanceAG'\n  | 'PrivateLabel'\n  | 'QUICPay'\n  | 'Suica'\n  | 'Visa'\n  | 'visa'\n  | 'VPay'\n  | 'vPay';\n\nexport type ApplePayMerchantCapability = '3DS' | 'credit' | 'debit' | 'emv';\n\nexport type ApplePaySummaryItemType = 'final' | 'pending';\n\nexport type ApplePayContactField = 'emailAddress' | 'name' | 'phoneNumber' | 'postalAddress';\n\nexport type ApplePayShippingType = 'shipping' | 'delivery' | 'servicePickup' | 'storePickup';\n\nexport interface ApplePaySummaryItem {\n  label: string;\n  amount: string;\n  type?: ApplePaySummaryItemType;\n}\n\nexport type ApplePayRecurringPaymentIntervalUnit = 'day' | 'week' | 'month' | 'year';\n\nexport interface ApplePayRecurringPaymentSummaryItem extends ApplePaySummaryItem {\n  /**\n   * Unit of time between recurring payments.\n   */\n  intervalUnit: ApplePayRecurringPaymentIntervalUnit;\n  /**\n   * Number of `intervalUnit` units between recurring payments (for example `1` month, `2` weeks).\n   */\n  intervalCount: number;\n  /**\n   * Start date of the recurring period.\n   *\n   * On supported platforms this may be either:\n   * - a `number` representing milliseconds since Unix epoch, or\n   * - a `string` in a date format accepted by the native implementation\n   *   (for example an ISO 8601 date-time string or a `yyyy-MM-dd` date string).\n   */\n  startDate?: number | string;\n  /**\n   * End date of the recurring period.\n   *\n   * On supported platforms this may be either:\n   * - a `number` representing milliseconds since Unix epoch, or\n   * - a `string` in a date format accepted by the native implementation\n   *   (for example an ISO 8601 date-time string or a `yyyy-MM-dd` date string).\n   */\n  endDate?: number | string;\n}\n\nexport interface ApplePayRecurringPaymentRequest {\n  /**\n   * A description for the recurring payment shown in the Apple Pay sheet.\n   */\n  paymentDescription: string;\n  /**\n   * The recurring billing item (for example your subscription).\n   */\n  regularBilling: ApplePayRecurringPaymentSummaryItem;\n  /**\n   * URL where the user can manage the recurring payment (cancel, update, etc).\n   */\n  managementURL: string;\n  /**\n   * Optional billing agreement text shown to the user.\n   */\n  billingAgreement?: string;\n  /**\n   * Optional URL where Apple can send token update notifications.\n   */\n  tokenNotificationURL?: string;\n  /**\n   * Optional trial billing item (for example a free trial period).\n   */\n  trialBilling?: ApplePayRecurringPaymentSummaryItem;\n}\n\nexport interface ApplePayAvailabilityOptions {\n  /**\n   * Optional list of payment networks you intend to use.\n   * Passing networks determines the return value of `canMakePaymentsUsingNetworks`.\n   */\n  supportedNetworks?: ApplePayNetwork[];\n}\n\nexport interface ApplePayAvailabilityResult {\n  /**\n   * Indicates whether the device can make Apple Pay payments in general.\n   */\n  canMakePayments: boolean;\n  /**\n   * Indicates whether the device can make Apple Pay payments with the supplied networks.\n   */\n  canMakePaymentsUsingNetworks: boolean;\n}\n\nexport interface ApplePayPaymentOptions {\n  /**\n   * Merchant identifier created in the Apple Developer portal.\n   */\n  merchantIdentifier: string;\n  /**\n   * Two-letter ISO 3166 country code.\n   */\n  countryCode: string;\n  /**\n   * Three-letter ISO 4217 currency code.\n   */\n  currencyCode: string;\n  /**\n   * Payment summary items displayed in the Apple Pay sheet.\n   */\n  paymentSummaryItems: ApplePaySummaryItem[];\n  /**\n   * Card networks to support.\n   */\n  supportedNetworks: ApplePayNetwork[];\n  /**\n   * Merchant payment capabilities. Defaults to ['3DS'] when omitted.\n   */\n  merchantCapabilities?: ApplePayMerchantCapability[];\n  /**\n   * Contact fields that must be supplied for shipping.\n   */\n  requiredShippingContactFields?: ApplePayContactField[];\n  /**\n   * Contact fields that must be supplied for billing.\n   */\n  requiredBillingContactFields?: ApplePayContactField[];\n  /**\n   * Controls the shipping flow presented to the user.\n   */\n  shippingType?: ApplePayShippingType;\n  /**\n   * Optional ISO 3166 country codes where the merchant is supported.\n   */\n  supportedCountries?: string[];\n  /**\n   * Optional opaque application data passed back in the payment token.\n   */\n  applicationData?: string;\n\n  /**\n   * Recurring payment configuration (iOS 16+).\n   */\n  recurringPaymentRequest?: ApplePayRecurringPaymentRequest;\n}\n\nexport interface ApplePayContact {\n  name?: {\n    givenName?: string;\n    familyName?: string;\n    middleName?: string;\n    namePrefix?: string;\n    nameSuffix?: string;\n    nickname?: string;\n  };\n  emailAddress?: string;\n  phoneNumber?: string;\n  postalAddress?: {\n    street?: string;\n    city?: string;\n    state?: string;\n    postalCode?: string;\n    country?: string;\n    isoCountryCode?: string;\n    subAdministrativeArea?: string;\n    subLocality?: string;\n  };\n}\n\nexport interface ApplePayPaymentResult {\n  /**\n   * Raw payment token encoded as base64 string.\n   */\n  paymentData: string;\n  /**\n   * Raw payment token JSON string, useful for debugging.\n   */\n  paymentString: string;\n  /**\n   * Payment transaction identifier.\n   */\n  transactionIdentifier: string;\n  paymentMethod: {\n    displayName?: string;\n    network?: ApplePayNetwork;\n    type: 'debit' | 'credit' | 'prepaid' | 'store';\n  };\n  shippingContact?: ApplePayContact;\n  billingContact?: ApplePayContact;\n}\n\nexport type GooglePayEnvironment = 'test' | 'production';\n\nexport type GooglePayCardNetwork =\n  | 'AMEX'\n  | 'DISCOVER'\n  | 'JCB'\n  | 'MASTERCARD'\n  | 'VISA'\n  // Keep this open-ended so users can pass new/region-specific networks without waiting for a release.\n  | (string & Record<never, never>);\n\nexport type GooglePayAuthMethod =\n  | 'PAN_ONLY'\n  | 'CRYPTOGRAM_3DS'\n  // Keep this open-ended for forward compatibility.\n  | (string & Record<never, never>);\n\nexport type GooglePayTotalPriceStatus = 'NOT_CURRENTLY_KNOWN' | 'ESTIMATED' | 'FINAL' | (string & Record<never, never>);\n\nexport interface GooglePayBillingAddressParameters {\n  format?: 'MIN' | 'FULL' | (string & Record<never, never>);\n  phoneNumberRequired?: boolean;\n}\n\nexport interface GooglePayCardPaymentMethodParameters {\n  allowedAuthMethods?: GooglePayAuthMethod[];\n  allowedCardNetworks?: GooglePayCardNetwork[];\n  billingAddressRequired?: boolean;\n  billingAddressParameters?: GooglePayBillingAddressParameters;\n}\n\nexport interface GooglePayTokenizationSpecification {\n  type?: 'PAYMENT_GATEWAY' | 'DIRECT' | (string & Record<never, never>);\n  parameters?: Record<string, string>;\n}\n\nexport interface GooglePayAllowedPaymentMethod {\n  type?: 'CARD' | (string & Record<never, never>);\n  parameters?: GooglePayCardPaymentMethodParameters;\n  tokenizationSpecification?: GooglePayTokenizationSpecification;\n}\n\nexport interface GooglePayMerchantInfo {\n  merchantId?: string;\n  merchantName?: string;\n}\n\nexport interface GooglePayTransactionInfo {\n  totalPriceStatus?: GooglePayTotalPriceStatus;\n  totalPrice?: string;\n  currencyCode?: string;\n  countryCode?: string;\n}\n\n/**\n * Typed helper for the Google Pay `IsReadyToPayRequest` JSON.\n * The native Android implementation still accepts arbitrary JSON (forward compatible).\n */\nexport interface GooglePayIsReadyToPayRequest {\n  /**\n   * The list of payment methods you want to check for readiness.\n   */\n  allowedPaymentMethods?: GooglePayAllowedPaymentMethod[];\n  /**\n   * Forward-compatible escape hatch for additional fields supported by Google Pay.\n   */\n  [key: string]: unknown;\n}\n\n/**\n * Typed helper for the Google Pay `PaymentDataRequest` JSON.\n * The native Android implementation still accepts arbitrary JSON (forward compatible).\n */\nexport interface GooglePayPaymentDataRequest {\n  /**\n   * Google Pay API version, typically `2`.\n   */\n  apiVersion?: number;\n  /**\n   * Google Pay API minor version, typically `0`.\n   */\n  apiVersionMinor?: number;\n  /**\n   * Allowed payment method configurations.\n   */\n  allowedPaymentMethods?: GooglePayAllowedPaymentMethod[];\n  /**\n   * Merchant information displayed in the Google Pay sheet.\n   */\n  merchantInfo?: GooglePayMerchantInfo;\n  /**\n   * Transaction details (amount, currency, etc).\n   */\n  transactionInfo?: GooglePayTransactionInfo;\n  /**\n   * Forward-compatible escape hatch for additional fields supported by Google Pay.\n   */\n  [key: string]: unknown;\n}\n\nexport interface GooglePayAvailabilityOptions {\n  /**\n   * Environment used to construct the Google Payments client. Defaults to `'test'`.\n   */\n  environment?: GooglePayEnvironment;\n  /**\n   * Raw `IsReadyToPayRequest` JSON as defined by the Google Pay API.\n   * Supply the card networks and auth methods you intend to support at runtime.\n   */\n  isReadyToPayRequest?: GooglePayIsReadyToPayRequest;\n}\n\nexport interface GooglePayAvailabilityResult {\n  /**\n   * Indicates whether the Google Pay API is available for the supplied parameters.\n   */\n  isReady: boolean;\n}\n\nexport interface GooglePayPaymentOptions {\n  /**\n   * Environment used to construct the Google Payments client. Defaults to `'test'`.\n   */\n  environment?: GooglePayEnvironment;\n  /**\n   * Raw `PaymentDataRequest` JSON as defined by the Google Pay API.\n   * Provide transaction details, merchant info, and tokenization parameters.\n   */\n  paymentDataRequest: GooglePayPaymentDataRequest;\n}\n\nexport interface GooglePayPaymentResult {\n  /**\n   * Payment data returned by Google Pay.\n   */\n  paymentData: Record<string, unknown>;\n}\n\nexport interface PayAvailabilityOptions {\n  apple?: ApplePayAvailabilityOptions;\n  google?: GooglePayAvailabilityOptions;\n}\n\nexport interface PayAvailabilityResult {\n  available: boolean;\n  platform: PayPlatform;\n  apple?: ApplePayAvailabilityResult;\n  google?: GooglePayAvailabilityResult;\n}\n\nexport interface PayPaymentOptions {\n  apple?: ApplePayPaymentOptions;\n  google?: GooglePayPaymentOptions;\n}\n\nexport interface PayPaymentResult {\n  platform: Exclude<PayPlatform, 'web'>;\n  apple?: ApplePayPaymentResult;\n  google?: GooglePayPaymentResult;\n}\n\nexport interface PayPlugin {\n  /**\n   * Checks whether native pay is available on the current platform.\n   * On iOS this evaluates Apple Pay, on Android it evaluates Google Pay.\n   */\n  isPayAvailable(options?: PayAvailabilityOptions): Promise<PayAvailabilityResult>;\n  /**\n   * Presents the native pay sheet for the current platform.\n   * Provide the Apple Pay configuration on iOS and the Google Pay configuration on Android.\n   */\n  requestPayment(options: PayPaymentOptions): Promise<PayPaymentResult>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}

package/docs/apple-pay-setup.md

@@ -72,6 +72,46 @@ Your server must broker the merchant validation handshake before the device can
 - Provide a list of networks (`supportedNetworks`) that matches the networks approved by your processor.
 - Include realistic summary items and ensure the total is a final amount.
 
+## Recurring payments (subscriptions)
+
+This plugin supports Apple Pay recurring payments on **iOS 16+** via `recurringPaymentRequest`.
+
+Key points:
+
+- You still provide `paymentSummaryItems` (what’s shown in the sheet).
+- The recurring metadata is provided via `recurringPaymentRequest`.
+- If you pass `recurringPaymentRequest` on iOS 15 or earlier, the plugin rejects the call.
+
+Example:
+
+```ts
+import { Pay } from '@capgo/capacitor-pay';
+
+await Pay.requestPayment({
+  apple: {
+    merchantIdentifier: 'merchant.com.example.app',
+    countryCode: 'US',
+    currencyCode: 'USD',
+    supportedNetworks: ['visa', 'masterCard'],
+    paymentSummaryItems: [
+      { label: 'Pro Plan', amount: '9.99' },
+      { label: 'Example Store', amount: '9.99' },
+    ],
+    recurringPaymentRequest: {
+      paymentDescription: 'Pro Plan Subscription',
+      managementURL: 'https://example.com/account/subscription',
+      regularBilling: {
+        label: 'Pro Plan',
+        amount: '9.99',
+        intervalUnit: 'month',
+        intervalCount: 1,
+        startDate: Date.now(),
+      },
+    },
+  },
+});
+```
+
 ## 9. Build and test on device
 
 - Apple Pay is unavailable on the iOS simulator. Use a real device signed into an Apple ID with a supported card in Wallet.

package/docs/google-pay-setup.md

@@ -61,6 +61,60 @@ Handle the encrypted payment data server-side before charging the customer:
    - `merchantInfo` for user-facing display
 3. Provide this JSON to `Pay.requestPayment({ google: { ... } })`.
 
+## Subscriptions / recurring charges
+
+Google Pay itself returns a **payment token** (or gateway payload). Subscriptions are typically implemented by:
+
+1. Collecting a token once using `Pay.requestPayment`.
+2. Sending the token to your backend.
+3. Creating and managing recurring charges with your PSP/gateway (Stripe/Adyen/Braintree/etc).
+
+Example `paymentDataRequest` (gateway tokenization):
+
+```ts
+import { Pay, type GooglePayPaymentDataRequest } from '@capgo/capacitor-pay';
+
+const paymentDataRequest: GooglePayPaymentDataRequest = {
+  apiVersion: 2,
+  apiVersionMinor: 0,
+  allowedPaymentMethods: [
+    {
+      type: 'CARD',
+      parameters: {
+        allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
+        allowedCardNetworks: ['AMEX', 'DISCOVER', 'MASTERCARD', 'VISA'],
+      },
+      tokenizationSpecification: {
+        type: 'PAYMENT_GATEWAY',
+        parameters: {
+          gateway: 'example',
+          gatewayMerchantId: 'exampleGatewayMerchantId',
+        },
+      },
+    },
+  ],
+  merchantInfo: {
+    merchantId: '01234567890123456789',
+    merchantName: 'Example Merchant',
+  },
+  transactionInfo: {
+    totalPriceStatus: 'FINAL',
+    totalPrice: '9.99',
+    currencyCode: 'USD',
+    countryCode: 'US',
+  },
+};
+
+const result = await Pay.requestPayment({
+  google: {
+    environment: 'test',
+    paymentDataRequest,
+  },
+});
+
+// Send `result.google?.paymentData` to your backend and use your PSP to start the subscription.
+```
+
 ## 8. Use the correct environment
 
 - During development, set `environment: 'test'` and rely on test card numbers.

package/ios/Sources/PayPlugin/PayPlugin.swift

@@ -5,7 +5,7 @@ import PassKit
 
 @objc(PayPlugin)
 public class PayPlugin: CAPPlugin, CAPBridgedPlugin, PKPaymentAuthorizationControllerDelegate {
-    private let pluginVersion: String = "8.0.12"
+    private let pluginVersion: String = "8.1.0"
     public let identifier = "PayPlugin"
     public let jsName = "Pay"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -192,9 +192,196 @@ public class PayPlugin: CAPPlugin, CAPBridgedPlugin, PKPaymentAuthorizationContr
             }
         }
 
+        if let recurringOptions = options["recurringPaymentRequest"] as? [String: Any] {
+            if #available(iOS 16.0, *) {
+                paymentRequest.recurringPaymentRequest = try buildRecurringPaymentRequest(from: recurringOptions)
+            } else {
+                throw PayPluginError.invalidConfiguration("`recurringPaymentRequest` requires iOS 16 or later.")
+            }
+        }
+
         return paymentRequest
     }
 
+    @available(iOS 16.0, *)
+    /// Builds a PassKit recurring payment request (`PKRecurringPaymentRequest`) from the JS options object.
+    private func buildRecurringPaymentRequest(from options: [String: Any]) throws -> PKRecurringPaymentRequest {
+        guard let paymentDescription = options["paymentDescription"] as? String, !paymentDescription.isEmpty else {
+            throw PayPluginError.invalidConfiguration("`recurringPaymentRequest.paymentDescription` is required.")
+        }
+
+        let regularBilling = try recurringPaymentSummaryItem(from: options["regularBilling"], fieldName: "recurringPaymentRequest.regularBilling")
+
+        guard let managementURLString = options["managementURL"] as? String,
+              let managementURL = URL(string: managementURLString) else {
+            throw PayPluginError.invalidConfiguration("`recurringPaymentRequest.managementURL` must be a valid URL string.")
+        }
+
+        let recurringRequest = PKRecurringPaymentRequest(
+            paymentDescription: paymentDescription,
+            regularBilling: regularBilling,
+            managementURL: managementURL
+        )
+
+        if let billingAgreement = options["billingAgreement"] as? String, !billingAgreement.isEmpty {
+            recurringRequest.billingAgreement = billingAgreement
+        }
+
+        if let tokenNotificationURLValue = options["tokenNotificationURL"] {
+            guard let tokenNotificationURLString = tokenNotificationURLValue as? String,
+                  let tokenNotificationURL = URL(string: tokenNotificationURLString) else {
+                throw PayPluginError.invalidConfiguration(
+                    "`recurringPaymentRequest.tokenNotificationURL` must be a valid URL string when provided."
+                )
+            }
+            recurringRequest.tokenNotificationURL = tokenNotificationURL
+        }
+
+        if let trialBillingRaw = options["trialBilling"] {
+            recurringRequest.trialBilling = try recurringPaymentSummaryItem(
+                from: trialBillingRaw,
+                fieldName: "recurringPaymentRequest.trialBilling"
+            )
+        }
+
+        return recurringRequest
+    }
+
+    @available(iOS 16.0, *)
+    /// Parses and validates a recurring payment summary item (regular or trial billing).
+    private func recurringPaymentSummaryItem(from value: Any?, fieldName: String) throws -> PKRecurringPaymentSummaryItem {
+        guard let rawItem = value as? [String: Any],
+              let label = rawItem["label"] as? String,
+              let amountString = rawItem["amount"] as? String else {
+            throw PayPluginError.invalidConfiguration("`\(fieldName)` must include `label` and `amount`.")
+        }
+
+        let amount = NSDecimalNumber(string: amountString)
+        if amount == NSDecimalNumber.notANumber {
+            throw PayPluginError.invalidConfiguration("`\(fieldName).amount` must be a valid decimal string.")
+        }
+
+        let item = PKRecurringPaymentSummaryItem(label: label, amount: amount)
+
+        if let typeString = rawItem["type"] as? String {
+            switch typeString.lowercased() {
+            case "pending":
+                item.type = .pending
+            default:
+                item.type = .final
+            }
+        }
+
+        if let intervalUnitRaw = rawItem["intervalUnit"] ?? rawItem["recurringPaymentIntervalUnit"],
+           let intervalUnit = parseRecurringIntervalUnit(from: intervalUnitRaw) {
+            item.intervalUnit = intervalUnit
+        } else {
+            throw PayPluginError.invalidConfiguration("`\(fieldName).intervalUnit` is required.")
+        }
+
+        if let intervalCountRaw = rawItem["intervalCount"] ?? rawItem["recurringPaymentIntervalCount"] {
+            if let intervalCount = parseInt(from: intervalCountRaw), intervalCount > 0 {
+                item.intervalCount = intervalCount
+            } else {
+                throw PayPluginError.invalidConfiguration("`\(fieldName).intervalCount` must be a positive integer.")
+            }
+        } else {
+            throw PayPluginError.invalidConfiguration("`\(fieldName).intervalCount` is required.")
+        }
+
+        if let startDateRaw = rawItem["startDate"] ?? rawItem["recurringPaymentStartDate"] {
+            guard let startDate = parseDate(from: startDateRaw) else {
+                throw PayPluginError.invalidConfiguration("`\(fieldName).startDate` must be a valid date.")
+            }
+            item.startDate = startDate
+        }
+
+        if let endDateRaw = rawItem["endDate"] ?? rawItem["recurringPaymentEndDate"] {
+            guard let endDate = parseDate(from: endDateRaw) else {
+                throw PayPluginError.invalidConfiguration("`\(fieldName).endDate` must be a valid date.")
+            }
+            item.endDate = endDate
+        }
+
+        return item
+    }
+
+    @available(iOS 16.0, *)
+    /// Maps string values used by Apple Pay on the Web to `NSCalendar.Unit` values required by PassKit.
+    private func parseRecurringIntervalUnit(from value: Any) -> NSCalendar.Unit? {
+        guard let stringValue = value as? String else {
+            return nil
+        }
+
+        switch stringValue.lowercased() {
+        case "day":
+            return .day
+        case "week":
+            return .weekOfYear
+        case "month":
+            return .month
+        case "year":
+            return .year
+        default:
+            return nil
+        }
+    }
+
+    /// Parses a positive integer from common JS number representations.
+    private func parseInt(from value: Any) -> Int? {
+        if let intValue = value as? Int {
+            return intValue
+        }
+        if let doubleValue = value as? Double {
+            guard doubleValue.isFinite,
+                  doubleValue.rounded() == doubleValue,
+                  doubleValue >= Double(Int.min),
+                  doubleValue <= Double(Int.max) else {
+                return nil
+            }
+            return Int(doubleValue)
+        }
+        if let stringValue = value as? String {
+            return Int(stringValue)
+        }
+        return nil
+    }
+
+    /// Parses a date from a JS value.
+    /// - For numbers, expects **milliseconds since Unix epoch**.
+    /// - For strings, accepts ISO 8601 and `yyyy-MM-dd` (UTC) formats.
+    private func parseDate(from value: Any) -> Date? {
+        if let doubleValue = value as? Double {
+            return parseDate(fromUnixNumeric: doubleValue)
+        }
+        if let intValue = value as? Int {
+            return parseDate(fromUnixNumeric: Double(intValue))
+        }
+        if let stringValue = value as? String {
+            let iso = ISO8601DateFormatter()
+            if let parsed = iso.date(from: stringValue) {
+                return parsed
+            }
+
+            // Common "YYYY-MM-DD" input used by Apple Pay examples.
+            let df = DateFormatter()
+            df.locale = Locale(identifier: "en_US_POSIX")
+            df.timeZone = TimeZone(secondsFromGMT: 0)
+            df.dateFormat = "yyyy-MM-dd"
+            return df.date(from: stringValue)
+        }
+
+        return nil
+    }
+
+    /// Parses a numeric date as **milliseconds since Unix epoch** (per the public TS contract).
+    private func parseDate(fromUnixNumeric value: Double) -> Date? {
+        guard value.isFinite else {
+            return nil
+        }
+        return Date(timeIntervalSince1970: value / 1000.0)
+    }
+
     private func paymentSummaryItems(from value: Any?) -> [PKPaymentSummaryItem] {
         guard let items = value as? [Any] else {
             return []
@@ -233,12 +420,42 @@ public class PayPlugin: CAPPlugin, CAPBridgedPlugin, PKPaymentAuthorizationContr
 
         return networkStrings.compactMap { element in
             if let stringValue = element as? String {
-                return PKPaymentNetwork(rawValue: stringValue)
+                return PKPaymentNetwork(rawValue: normalizePaymentNetwork(stringValue))
             }
             return nil
         }
     }
 
+    private func normalizePaymentNetwork(_ value: String) -> String {
+        let trimmed = value.trimmingCharacters(in: .whitespacesAndNewlines)
+        let key = trimmed.lowercased()
+
+        // Accept common Apple Pay on the Web identifiers too.
+        // PassKit network raw values are case-sensitive (for example "Visa", "MasterCard", "AmEx").
+        switch key {
+        case "visa":
+            return PKPaymentNetwork.visa.rawValue
+        case "mastercard":
+            return PKPaymentNetwork.masterCard.rawValue
+        case "amex":
+            return PKPaymentNetwork.amex.rawValue
+        case "discover":
+            return PKPaymentNetwork.discover.rawValue
+        case "jcb":
+            return PKPaymentNetwork.JCB.rawValue
+        case "vpay":
+            return PKPaymentNetwork.vPay.rawValue
+        case "maestro":
+            return PKPaymentNetwork.maestro.rawValue
+        case "girocard":
+            return PKPaymentNetwork.girocard.rawValue
+        case "mada":
+            return PKPaymentNetwork.mada.rawValue
+        default:
+            return trimmed
+        }
+    }
+
     private func parseMerchantCapabilities(from values: [String]) -> PKMerchantCapability {
         var capabilities: PKMerchantCapability = []
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-pay",
-  "version": "8.0.12",
+  "version": "8.1.0",
   "description": "Capacitor plugin to trigger native payment for iOS(Apple pay) and Android(Google Pay)",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -35,20 +35,20 @@
     "Native payment"
   ],
   "scripts": {
-    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify": "bun run verify:ios && bun run verify:android && bun run verify:web",
     "verify:ios": "xcodebuild -scheme CapgoCapacitorPay -destination generic/platform=iOS",
     "verify:android": "cd android && ./gradlew clean build test && cd ..",
-    "verify:web": "npm run build",
-    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
-    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "verify:web": "bun run build",
+    "lint": "bun run eslint && bun run prettier -- --check && bun run swiftlint -- lint",
+    "fmt": "bun run eslint -- --fix && bun run prettier -- --write && bun run swiftlint -- --fix --format",
     "eslint": "eslint . --ext ts",
     "prettier": "prettier-pretty-check \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
     "swiftlint": "node-swiftlint",
     "docgen": "docgen --api PayPlugin --output-readme README.md --output-json dist/docs.json",
-    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "build": "bun run clean && bun run docgen && tsc && rollup -c rollup.config.mjs",
     "clean": "rimraf ./dist",
     "watch": "tsc --watch",
-    "prepublishOnly": "npm run build",
+    "prepublishOnly": "bun run build",
     "check:wiring": "node scripts/check-capacitor-plugin-wiring.mjs"
   },
   "devDependencies": {