@capgo/capacitor-pay 7.0.0

package/dist/esm/definitions.d.ts

@@ -0,0 +1,183 @@
+export declare type PayPlatform = 'ios' | 'android' | 'web';
+export declare type ApplePayNetwork = 'amex' | 'chinaUnionPay' | 'discover' | 'eftpos' | 'electron' | 'girocard' | 'interac' | 'jcb' | 'mada' | 'maestro' | 'masterCard' | 'privateLabel' | 'quicPay' | 'suica' | 'visa' | 'vPay' | 'id' | 'cartesBancaires';
+export declare type ApplePayMerchantCapability = '3DS' | 'credit' | 'debit' | 'emv';
+export declare type ApplePaySummaryItemType = 'final' | 'pending';
+export declare type ApplePayContactField = 'emailAddress' | 'name' | 'phoneNumber' | 'postalAddress';
+export declare type ApplePayShippingType = 'shipping' | 'delivery' | 'servicePickup' | 'storePickup';
+export interface ApplePaySummaryItem {
+    label: string;
+    amount: string;
+    type?: ApplePaySummaryItemType;
+}
+export interface ApplePayAvailabilityOptions {
+    /**
+     * Optional list of payment networks you intend to use.
+     * Passing networks determines the return value of `canMakePaymentsUsingNetworks`.
+     */
+    supportedNetworks?: ApplePayNetwork[];
+}
+export interface ApplePayAvailabilityResult {
+    /**
+     * Indicates whether the device can make Apple Pay payments in general.
+     */
+    canMakePayments: boolean;
+    /**
+     * Indicates whether the device can make Apple Pay payments with the supplied networks.
+     */
+    canMakePaymentsUsingNetworks: boolean;
+}
+export interface ApplePayPaymentOptions {
+    /**
+     * Merchant identifier created in the Apple Developer portal.
+     */
+    merchantIdentifier: string;
+    /**
+     * Two-letter ISO 3166 country code.
+     */
+    countryCode: string;
+    /**
+     * Three-letter ISO 4217 currency code.
+     */
+    currencyCode: string;
+    /**
+     * Payment summary items displayed in the Apple Pay sheet.
+     */
+    paymentSummaryItems: ApplePaySummaryItem[];
+    /**
+     * Card networks to support.
+     */
+    supportedNetworks: ApplePayNetwork[];
+    /**
+     * Merchant payment capabilities. Defaults to ['3DS'] when omitted.
+     */
+    merchantCapabilities?: ApplePayMerchantCapability[];
+    /**
+     * Contact fields that must be supplied for shipping.
+     */
+    requiredShippingContactFields?: ApplePayContactField[];
+    /**
+     * Contact fields that must be supplied for billing.
+     */
+    requiredBillingContactFields?: ApplePayContactField[];
+    /**
+     * Controls the shipping flow presented to the user.
+     */
+    shippingType?: ApplePayShippingType;
+    /**
+     * Optional ISO 3166 country codes where the merchant is supported.
+     */
+    supportedCountries?: string[];
+    /**
+     * Optional opaque application data passed back in the payment token.
+     */
+    applicationData?: string;
+}
+export interface ApplePayContact {
+    name?: {
+        givenName?: string;
+        familyName?: string;
+        middleName?: string;
+        namePrefix?: string;
+        nameSuffix?: string;
+        nickname?: string;
+    };
+    emailAddress?: string;
+    phoneNumber?: string;
+    postalAddress?: {
+        street?: string;
+        city?: string;
+        state?: string;
+        postalCode?: string;
+        country?: string;
+        isoCountryCode?: string;
+        subAdministrativeArea?: string;
+        subLocality?: string;
+    };
+}
+export interface ApplePayPaymentResult {
+    /**
+     * Raw payment token encoded as base64 string.
+     */
+    paymentData: string;
+    /**
+     * Raw payment token JSON string, useful for debugging.
+     */
+    paymentString: string;
+    /**
+     * Payment transaction identifier.
+     */
+    transactionIdentifier: string;
+    paymentMethod: {
+        displayName?: string;
+        network?: ApplePayNetwork;
+        type: 'debit' | 'credit' | 'prepaid' | 'store';
+    };
+    shippingContact?: ApplePayContact;
+    billingContact?: ApplePayContact;
+}
+export declare type GooglePayEnvironment = 'test' | 'production';
+export interface GooglePayAvailabilityOptions {
+    /**
+     * Environment used to construct the Google Payments client. Defaults to `'test'`.
+     */
+    environment?: GooglePayEnvironment;
+    /**
+     * 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>;
+}
+export interface GooglePayAvailabilityResult {
+    /**
+     * Indicates whether the Google Pay API is available for the supplied parameters.
+     */
+    isReady: boolean;
+}
+export interface GooglePayPaymentOptions {
+    /**
+     * Environment used to construct the Google Payments client. Defaults to `'test'`.
+     */
+    environment?: GooglePayEnvironment;
+    /**
+     * Raw `PaymentDataRequest` JSON as defined by the Google Pay API.
+     * Provide transaction details, merchant info, and tokenization parameters.
+     */
+    paymentDataRequest: Record<string, unknown>;
+}
+export interface GooglePayPaymentResult {
+    /**
+     * Payment data returned by Google Pay.
+     */
+    paymentData: Record<string, unknown>;
+}
+export interface PayAvailabilityOptions {
+    apple?: ApplePayAvailabilityOptions;
+    google?: GooglePayAvailabilityOptions;
+}
+export interface PayAvailabilityResult {
+    available: boolean;
+    platform: PayPlatform;
+    apple?: ApplePayAvailabilityResult;
+    google?: GooglePayAvailabilityResult;
+}
+export interface PayPaymentOptions {
+    apple?: ApplePayPaymentOptions;
+    google?: GooglePayPaymentOptions;
+}
+export interface PayPaymentResult {
+    platform: Exclude<PayPlatform, 'web'>;
+    apple?: ApplePayPaymentResult;
+    google?: GooglePayPaymentResult;
+}
+export interface PayPlugin {
+    /**
+     * Checks whether native pay is available on the current platform.
+     * On iOS this evaluates Apple Pay, on Android it evaluates Google Pay.
+     */
+    isPayAvailable(options?: PayAvailabilityOptions): Promise<PayAvailabilityResult>;
+    /**
+     * Presents the native pay sheet for the current platform.
+     * Provide the Apple Pay configuration on iOS and the Google Pay configuration on Android.
+     */
+    requestPayment(options: PayPaymentOptions): Promise<PayPaymentResult>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +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  | 'chinaUnionPay'\n  | 'discover'\n  | 'eftpos'\n  | 'electron'\n  | 'girocard'\n  | 'interac'\n  | 'jcb'\n  | 'mada'\n  | 'maestro'\n  | 'masterCard'\n  | 'privateLabel'\n  | 'quicPay'\n  | 'suica'\n  | 'visa'\n  | 'vPay'\n  | 'id'\n  | 'cartesBancaires';\n\nexport type ApplePayMerchantCapability = '3DS' | 'credit' | 'debit' | 'emv';\n\nexport type ApplePaySummaryItemType = 'final' | 'pending';\n\nexport type ApplePayContactField =\n  | 'emailAddress'\n  | 'name'\n  | 'phoneNumber'\n  | 'postalAddress';\n\nexport type ApplePayShippingType =\n  | 'shipping'\n  | 'delivery'\n  | 'servicePickup'\n  | '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"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { PayPlugin } from './definitions';
+declare const Pay: PayPlugin;
+export * from './definitions';
+export { Pay };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const Pay = registerPlugin('Pay', {
+    web: () => import('./web').then((m) => new m.PayWeb()),
+});
+export * from './definitions';
+export { Pay };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,GAAG,GAAG,cAAc,CAAY,KAAK,EAAE;IAC3C,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;CACvD,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { PayPlugin } from './definitions';\n\nconst Pay = registerPlugin<PayPlugin>('Pay', {\n  web: () => import('./web').then((m) => new m.PayWeb()),\n});\n\nexport * from './definitions';\nexport { Pay };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,6 @@
+import { WebPlugin } from '@capacitor/core';
+import type { PayAvailabilityOptions, PayAvailabilityResult, PayPaymentOptions, PayPaymentResult, PayPlugin } from './definitions';
+export declare class PayWeb extends WebPlugin implements PayPlugin {
+    isPayAvailable(_options?: PayAvailabilityOptions): Promise<PayAvailabilityResult>;
+    requestPayment(_options: PayPaymentOptions): Promise<PayPaymentResult>;
+}

package/dist/esm/web.js

@@ -0,0 +1,20 @@
+import { WebPlugin } from '@capacitor/core';
+export class PayWeb extends WebPlugin {
+    async isPayAvailable(_options) {
+        return {
+            available: false,
+            platform: 'web',
+            apple: {
+                canMakePayments: false,
+                canMakePaymentsUsingNetworks: false,
+            },
+            google: {
+                isReady: false,
+            },
+        };
+    }
+    async requestPayment(_options) {
+        throw this.unimplemented('Native payments are not implemented on the web. Use a native platform.');
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C,MAAM,OAAO,MAAO,SAAQ,SAAS;IACnC,KAAK,CAAC,cAAc,CAClB,QAAiC;QAEjC,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE;gBACL,eAAe,EAAE,KAAK;gBACtB,4BAA4B,EAAE,KAAK;aACpC;YACD,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;aACf;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAA2B;QAC9C,MAAM,IAAI,CAAC,aAAa,CACtB,wEAAwE,CACzE,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  PayAvailabilityOptions,\n  PayAvailabilityResult,\n  PayPaymentOptions,\n  PayPaymentResult,\n  PayPlugin,\n} from './definitions';\n\nexport class PayWeb extends WebPlugin implements PayPlugin {\n  async isPayAvailable(\n    _options?: PayAvailabilityOptions,\n  ): Promise<PayAvailabilityResult> {\n    return {\n      available: false,\n      platform: 'web',\n      apple: {\n        canMakePayments: false,\n        canMakePaymentsUsingNetworks: false,\n      },\n      google: {\n        isReady: false,\n      },\n    };\n  }\n\n  async requestPayment(_options: PayPaymentOptions): Promise<PayPaymentResult> {\n    throw this.unimplemented(\n      'Native payments are not implemented on the web. Use a native platform.',\n    );\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,34 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const Pay = core.registerPlugin('Pay', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.PayWeb()),
+});
+
+class PayWeb extends core.WebPlugin {
+    async isPayAvailable(_options) {
+        return {
+            available: false,
+            platform: 'web',
+            apple: {
+                canMakePayments: false,
+                canMakePaymentsUsingNetworks: false,
+            },
+            google: {
+                isReady: false,
+            },
+        };
+    }
+    async requestPayment(_options) {
+        throw this.unimplemented('Native payments are not implemented on the web. Use a native platform.');
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    PayWeb: PayWeb
+});
+
+exports.Pay = Pay;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Pay = registerPlugin('Pay', {\n    web: () => import('./web').then((m) => new m.PayWeb()),\n});\nexport * from './definitions';\nexport { Pay };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class PayWeb extends WebPlugin {\n    async isPayAvailable(_options) {\n        return {\n            available: false,\n            platform: 'web',\n            apple: {\n                canMakePayments: false,\n                canMakePaymentsUsingNetworks: false,\n            },\n            google: {\n                isReady: false,\n            },\n        };\n    }\n    async requestPayment(_options) {\n        throw this.unimplemented('Native payments are not implemented on the web. Use a native platform.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,GAAG,GAAGA,mBAAc,CAAC,KAAK,EAAE;AAClC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1D,CAAC;;ACFM,MAAM,MAAM,SAASC,cAAS,CAAC;AACtC,IAAI,MAAM,cAAc,CAAC,QAAQ,EAAE;AACnC,QAAQ,OAAO;AACf,YAAY,SAAS,EAAE,KAAK;AAC5B,YAAY,QAAQ,EAAE,KAAK;AAC3B,YAAY,KAAK,EAAE;AACnB,gBAAgB,eAAe,EAAE,KAAK;AACtC,gBAAgB,4BAA4B,EAAE,KAAK;AACnD,aAAa;AACb,YAAY,MAAM,EAAE;AACpB,gBAAgB,OAAO,EAAE,KAAK;AAC9B,aAAa;AACb,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,cAAc,CAAC,QAAQ,EAAE;AACnC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,wEAAwE,CAAC;AAC1G,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,37 @@
+var capacitorPay = (function (exports, core) {
+    'use strict';
+
+    const Pay = core.registerPlugin('Pay', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.PayWeb()),
+    });
+
+    class PayWeb extends core.WebPlugin {
+        async isPayAvailable(_options) {
+            return {
+                available: false,
+                platform: 'web',
+                apple: {
+                    canMakePayments: false,
+                    canMakePaymentsUsingNetworks: false,
+                },
+                google: {
+                    isReady: false,
+                },
+            };
+        }
+        async requestPayment(_options) {
+            throw this.unimplemented('Native payments are not implemented on the web. Use a native platform.');
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        PayWeb: PayWeb
+    });
+
+    exports.Pay = Pay;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Pay = registerPlugin('Pay', {\n    web: () => import('./web').then((m) => new m.PayWeb()),\n});\nexport * from './definitions';\nexport { Pay };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class PayWeb extends WebPlugin {\n    async isPayAvailable(_options) {\n        return {\n            available: false,\n            platform: 'web',\n            apple: {\n                canMakePayments: false,\n                canMakePaymentsUsingNetworks: false,\n            },\n            google: {\n                isReady: false,\n            },\n        };\n    }\n    async requestPayment(_options) {\n        throw this.unimplemented('Native payments are not implemented on the web. Use a native platform.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,GAAG,GAAGA,mBAAc,CAAC,KAAK,EAAE;IAClC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1D,CAAC;;ICFM,MAAM,MAAM,SAASC,cAAS,CAAC;IACtC,IAAI,MAAM,cAAc,CAAC,QAAQ,EAAE;IACnC,QAAQ,OAAO;IACf,YAAY,SAAS,EAAE,KAAK;IAC5B,YAAY,QAAQ,EAAE,KAAK;IAC3B,YAAY,KAAK,EAAE;IACnB,gBAAgB,eAAe,EAAE,KAAK;IACtC,gBAAgB,4BAA4B,EAAE,KAAK;IACnD,aAAa;IACb,YAAY,MAAM,EAAE;IACpB,gBAAgB,OAAO,EAAE,KAAK;IAC9B,aAAa;IACb,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,cAAc,CAAC,QAAQ,EAAE;IACnC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,wEAAwE,CAAC;IAC1G,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/docs/apple-pay-setup.md

@@ -0,0 +1,67 @@
+# Apple Pay Setup Guide
+
+This document walks through the steps required to enable Apple Pay in a project that uses `@capgo/capacitor-pay`. Complete every step before calling the plugin at runtime.
+
+## 1. Accounts and prerequisites
+
+- Enroll in the Apple Developer Program using the same Apple ID that signs your iOS builds.
+- Ensure your app bundle identifier is reserved in App Store Connect.
+- Use Xcode 14 or newer, and install the latest iOS SDK.
+
+## 2. Create a Merchant ID
+
+1. Open [Apple Developer > Certificates, Identifiers & Profiles](https://developer.apple.com/account/resources/identifiers/list).
+2. In **Identifiers**, click the plus button and choose **Merchant IDs**.
+3. Enter a description and a unique identifier following the pattern `merchant.com.yourcompany.app`.
+4. Save the identifier. This Merchant ID will later be referenced in code as `merchantIdentifier`.
+
+## 3. Add the Apple Pay capability
+
+1. Open the iOS workspace or the Capacitor iOS project in Xcode.
+2. Select the app target, open the **Signing & Capabilities** tab, and click **+ Capability**.
+3. Choose **Apple Pay**, then select the merchant ID you created earlier.
+4. Xcode generates an `App.entitlements` file with the `com.apple.developer.in-app-payments` entry. Confirm that the Merchant ID is listed.
+
+## 4. Generate the payment processing certificate
+
+1. In the developer portal, open the Merchant ID details.
+2. Under **Payment Processing Certificate**, click **Create Certificate**.
+3. Download the certificate signing request (`.certSigningRequest`) generated by Xcode (`Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority`).
+4. Upload the CSR, download the resulting certificate, and double-click it to add it to your keychain.
+5. Export the certificate as a `.cer` file and keep it for your payment service provider if required.
+
+## 5. Configure the payment processor or gateway
+
+Most processors request the Merchant ID and the payment processing certificate. Provide:
+
+- Merchant identifier (e.g., `merchant.com.yourcompany.app`)
+- Business legal name and contact information
+- The `.cer` file generated in the previous step
+
+Follow your processor’s onboarding steps to complete tokenization.
+
+## 6. Verify domain association (if applicable)
+
+If your payment processor requires Apple Pay on the web, add your site domain in the developer portal and upload the `apple-developer-merchantid-domain-association` file to `https://<domain>/.well-known/`.
+
+## 7. Update the Capacitor project
+
+- In `Pay.requestPayment`, set `merchantIdentifier` to the Merchant ID created earlier.
+- 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.
+
+## 8. 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.
+- Install the build via Xcode or TestFlight.
+- Trigger `Pay.isPayAvailable()` to ensure the device reports `available: true`.
+- Call `Pay.requestPayment` and verify that the Apple Pay sheet loads and returns a payment token.
+
+## 9. Move to production
+
+- Disable the sandbox merchant environment in your processor dashboard once you’re ready for production.
+- Rebuild the app using distribution certificates and submit the build for App Review.
+- Provide Apple with sample test accounts or screenshots showing the Apple Pay flow, if requested.
+
+After these steps the Capacitor plugin can successfully authorize payments using Apple Pay.
+

package/docs/google-pay-setup.md

@@ -0,0 +1,70 @@
+# Google Pay Setup Guide
+
+Follow this checklist to enable Google Pay for the Android implementation of `@capgo/capacitor-pay`.
+
+## 1. Requirements
+
+- A Google Play Console account with the correct app package name registered.
+- Access to the Google Pay & Wallet Console using the same Google account.
+- Android Studio Hedgehog (or newer) with the latest Android SDK tools.
+- Test devices running Google Play services.
+
+## 2. Create a Google Pay business profile
+
+1. Open the [Google Pay & Wallet Console](https://pay.google.com/business/console/).
+2. Create or select a business profile that matches your legal entity.
+3. Provide the merchant name that will appear in the Google Pay sheet.
+4. Verify any requested documentation to enable production processing.
+
+## 3. Configure payment processing
+
+Decide between a **gateway** (e.g., Stripe, Adyen, Braintree) or **direct** processor integration:
+
+- For gateway tokenization, collect the `gateway` and `gatewayMerchantId` values.
+- For direct tokenization, create and store your public/private key pair and obtain your processor’s parameters.
+
+Document these values because they must be inserted into the `paymentDataRequest.tokenizationSpecification`.
+
+## 4. Register test cards and test users
+
+1. In the Google Pay console, add testing cards or enable the demo cards.
+2. On every test device, add one of the sandbox cards to Google Wallet.
+3. Install the latest Google Play services if prompted.
+
+## 5. Update the Android project
+
+1. Ensure `com.google.android.gms:play-services-wallet` is included in `android/build.gradle` (already added by the plugin).
+2. In your app code, build a `paymentDataRequest` JSON matching the processor configuration:
+   - `apiVersion` and `apiVersionMinor`
+   - `allowedPaymentMethods` with card networks and authentication methods
+   - `transactionInfo` containing price, currency, and country
+   - `merchantInfo` for user-facing display
+3. Provide this JSON to `Pay.requestPayment({ google: { ... } })`.
+
+## 6. Use the correct environment
+
+- During development, set `environment: 'test'` and rely on test card numbers.
+- For production builds, switch to `environment: 'production'` and ensure your business profile is approved.
+
+## 7. Add required app manifest entries
+
+Google Pay itself does not require additional manifest permissions beyond Internet access, but your processor may require network security configuration or HTTPS endpoints. Confirm:
+
+- `android:usesCleartextTraffic="false"` (or a network security config for dev environments).
+- Any callback URLs you use are served over HTTPS.
+
+## 8. Test on device
+
+1. Build and install the Android app on a device with the sandbox card.
+2. Call `Pay.isPayAvailable` with the same `isReadyToPayRequest` JSON you will use in production.
+3. Confirm the method returns `available: true` and `google.isReady: true`.
+4. Trigger `Pay.requestPayment` and complete a transaction with a test card to verify token payloads.
+
+## 9. Launch to production
+
+1. Submit your app for Google Play review with Google Pay screenshots or screen recordings if requested.
+2. Promote the business profile to production in the Google Pay & Wallet Console.
+3. Switch the runtime configuration to the production environment and merchant details.
+
+Completing these steps prepares your Android app to process payments through Google Pay using the Capacitor plugin.
+