@capgo/capacitor-pay 7.0.0

package/CapgoCapacitorPay.podspec

@@ -0,0 +1,18 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapgoCapacitorPay'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '14.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+  s.frameworks = 'PassKit'
+end

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapgoCapacitorPay",
+    platforms: [.iOS(.v14)],
+    products: [
+        .library(
+            name: "CapgoCapacitorPay",
+            targets: ["PayPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "7.0.0")
+    ],
+    targets: [
+        .target(
+            name: "PayPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/PayPlugin"),
+        .testTarget(
+            name: "PayPluginTests",
+            dependencies: ["PayPlugin"],
+            path: "ios/Tests/PayPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,350 @@
+# @capgo/capacitor-pay
+ <a href="https://capgo.app/"><img src='https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png' alt='Capgo - Instant updates for capacitor'/></a>
+
+<div align="center">
+  <h2><a href="https://capgo.app/?ref=plugin"> ➡️ Get Instant updates for your App with Capgo</a></h2>
+  <h2><a href="https://capgo.app/consulting/?ref=plugin"> Missing a feature? We’ll build the plugin for you 💪</a></h2>
+</div>
+
+Capacitor plugin to trigger native payments with Apple Pay and Google Pay using a unified JavaScript API.
+
+## Install
+
+```bash
+npm install @capgo/capacitor-pay
+npx cap sync
+```
+
+## Platform setup
+
+Before invoking the plugin, complete the native configuration documented in this repository:
+
+- **Apple Pay (iOS):** see [`docs/apple-pay-setup.md`](docs/apple-pay-setup.md) for merchant ID creation, certificates, Xcode entitlements, and device testing.
+- **Google Pay (Android):** follow [`docs/google-pay-setup.md`](docs/google-pay-setup.md) to configure the business profile, tokenization settings, and runtime JSON payloads.
+
+Finish both guides once per app to unlock the native payment sheets on devices.
+
+## Usage
+
+```ts
+import { Pay } from '@capgo/capacitor-pay';
+
+// Check availability on the current platform.
+const availability = await Pay.isPayAvailable({
+  apple: {
+    supportedNetworks: ['visa', 'masterCard', 'amex'],
+  },
+  google: {
+    // Optional: falls back to a basic CARD request if omitted.
+    isReadyToPayRequest: {
+      allowedPaymentMethods: [
+        {
+          type: 'CARD',
+          parameters: {
+            allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
+            allowedCardNetworks: ['AMEX', 'DISCOVER', 'MASTERCARD', 'VISA'],
+          },
+        },
+      ],
+    },
+  },
+});
+
+if (!availability.available) {
+  // Surface a friendly message or provide an alternative checkout.
+  return;
+}
+
+if (availability.platform === 'ios') {
+  const result = await Pay.requestPayment({
+    apple: {
+      merchantIdentifier: 'merchant.com.example.app',
+      countryCode: 'US',
+      currencyCode: 'USD',
+      supportedNetworks: ['visa', 'masterCard'],
+      paymentSummaryItems: [
+        { label: 'Example Product', amount: '19.99' },
+        { label: 'Tax', amount: '1.60' },
+        { label: 'Example Store', amount: '21.59' },
+      ],
+      requiredShippingContactFields: ['postalAddress', 'name', 'emailAddress'],
+    },
+  });
+  console.log(result.apple?.paymentData);
+} else if (availability.platform === 'android') {
+  const result = await Pay.requestPayment({
+    google: {
+      environment: 'test',
+      paymentDataRequest: {
+        apiVersion: 2,
+        apiVersionMinor: 0,
+        allowedPaymentMethods: [
+          {
+            type: 'CARD',
+            parameters: {
+              allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
+              allowedCardNetworks: ['AMEX', 'DISCOVER', 'MASTERCARD', 'VISA'],
+              billingAddressRequired: true,
+              billingAddressParameters: {
+                format: 'FULL',
+              },
+            },
+            tokenizationSpecification: {
+              type: 'PAYMENT_GATEWAY',
+              parameters: {
+                gateway: 'example',
+                gatewayMerchantId: 'exampleGatewayMerchantId',
+              },
+            },
+          },
+        ],
+        merchantInfo: {
+          merchantId: '01234567890123456789',
+          merchantName: 'Example Merchant',
+        },
+        transactionInfo: {
+          totalPriceStatus: 'FINAL',
+          totalPrice: '21.59',
+          currencyCode: 'USD',
+          countryCode: 'US',
+        },
+      },
+    },
+  });
+  console.log(result.google?.paymentData);
+}
+```
+
+## API
+
+<docgen-index>
+
+* [`isPayAvailable(...)`](#ispayavailable)
+* [`requestPayment(...)`](#requestpayment)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### isPayAvailable(...)
+
+```typescript
+isPayAvailable(options?: PayAvailabilityOptions | undefined) => Promise<PayAvailabilityResult>
+```
+
+Checks whether native pay is available on the current platform.
+On iOS this evaluates Apple Pay, on Android it evaluates Google Pay.
+
+| Param         | Type                                                                      |
+| ------------- | ------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#payavailabilityoptions">PayAvailabilityOptions</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#payavailabilityresult">PayAvailabilityResult</a>&gt;</code>
+
+--------------------
+
+
+### requestPayment(...)
+
+```typescript
+requestPayment(options: PayPaymentOptions) => Promise<PayPaymentResult>
+```
+
+Presents the native pay sheet for the current platform.
+Provide the Apple Pay configuration on iOS and the Google Pay configuration on Android.
+
+| Param         | Type                                                            |
+| ------------- | --------------------------------------------------------------- |
+| **`options`** | <code><a href="#paypaymentoptions">PayPaymentOptions</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#paypaymentresult">PayPaymentResult</a>&gt;</code>
+
+--------------------
+
+
+### Interfaces
+
+
+#### PayAvailabilityResult
+
+| Prop            | Type                                                                                |
+| --------------- | ----------------------------------------------------------------------------------- |
+| **`available`** | <code>boolean</code>                                                                |
+| **`platform`**  | <code><a href="#payplatform">PayPlatform</a></code>                                 |
+| **`apple`**     | <code><a href="#applepayavailabilityresult">ApplePayAvailabilityResult</a></code>   |
+| **`google`**    | <code><a href="#googlepayavailabilityresult">GooglePayAvailabilityResult</a></code> |
+
+
+#### ApplePayAvailabilityResult
+
+| Prop                               | Type                 | Description                                                                          |
+| ---------------------------------- | -------------------- | ------------------------------------------------------------------------------------ |
+| **`canMakePayments`**              | <code>boolean</code> | Indicates whether the device can make Apple Pay payments in general.                 |
+| **`canMakePaymentsUsingNetworks`** | <code>boolean</code> | Indicates whether the device can make Apple Pay payments with the supplied networks. |
+
+
+#### GooglePayAvailabilityResult
+
+| Prop          | Type                 | Description                                                                    |
+| ------------- | -------------------- | ------------------------------------------------------------------------------ |
+| **`isReady`** | <code>boolean</code> | Indicates whether the Google Pay API is available for the supplied parameters. |
+
+
+#### PayAvailabilityOptions
+
+| Prop         | Type                                                                                  |
+| ------------ | ------------------------------------------------------------------------------------- |
+| **`apple`**  | <code><a href="#applepayavailabilityoptions">ApplePayAvailabilityOptions</a></code>   |
+| **`google`** | <code><a href="#googlepayavailabilityoptions">GooglePayAvailabilityOptions</a></code> |
+
+
+#### ApplePayAvailabilityOptions
+
+| Prop                    | Type                           | Description                                                                                                                          |
+| ----------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
+| **`supportedNetworks`** | <code>ApplePayNetwork[]</code> | Optional list of payment networks you intend to use. Passing networks determines the return value of `canMakePaymentsUsingNetworks`. |
+
+
+#### GooglePayAvailabilityOptions
+
+| Prop                      | Type                                                                  | Description                                                                                                                                  |
+| ------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`environment`**         | <code><a href="#googlepayenvironment">GooglePayEnvironment</a></code> | Environment used to construct the Google Payments client. Defaults to `'test'`.                                                              |
+| **`isReadyToPayRequest`** | <code><a href="#record">Record</a>&lt;string, unknown&gt;</code>      | Raw `IsReadyToPayRequest` JSON as defined by the Google Pay API. Supply the card networks and auth methods you intend to support at runtime. |
+
+
+#### PayPaymentResult
+
+| Prop           | Type                                                                                             |
+| -------------- | ------------------------------------------------------------------------------------------------ |
+| **`platform`** | <code><a href="#exclude">Exclude</a>&lt;<a href="#payplatform">PayPlatform</a>, 'web'&gt;</code> |
+| **`apple`**    | <code><a href="#applepaypaymentresult">ApplePayPaymentResult</a></code>                          |
+| **`google`**   | <code><a href="#googlepaypaymentresult">GooglePayPaymentResult</a></code>                        |
+
+
+#### ApplePayPaymentResult
+
+| Prop                        | Type                                                                                                                                                | Description                                          |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
+| **`paymentData`**           | <code>string</code>                                                                                                                                 | Raw payment token encoded as base64 string.          |
+| **`paymentString`**         | <code>string</code>                                                                                                                                 | Raw payment token JSON string, useful for debugging. |
+| **`transactionIdentifier`** | <code>string</code>                                                                                                                                 | Payment transaction identifier.                      |
+| **`paymentMethod`**         | <code>{ displayName?: string; network?: <a href="#applepaynetwork">ApplePayNetwork</a>; type: 'credit' \| 'debit' \| 'prepaid' \| 'store'; }</code> |                                                      |
+| **`shippingContact`**       | <code><a href="#applepaycontact">ApplePayContact</a></code>                                                                                         |                                                      |
+| **`billingContact`**        | <code><a href="#applepaycontact">ApplePayContact</a></code>                                                                                         |                                                      |
+
+
+#### ApplePayContact
+
+| Prop                | Type                                                                                                                                                                                   |
+| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`name`**          | <code>{ givenName?: string; familyName?: string; middleName?: string; namePrefix?: string; nameSuffix?: string; nickname?: string; }</code>                                            |
+| **`emailAddress`**  | <code>string</code>                                                                                                                                                                    |
+| **`phoneNumber`**   | <code>string</code>                                                                                                                                                                    |
+| **`postalAddress`** | <code>{ street?: string; city?: string; state?: string; postalCode?: string; country?: string; isoCountryCode?: string; subAdministrativeArea?: string; subLocality?: string; }</code> |
+
+
+#### GooglePayPaymentResult
+
+| Prop              | Type                                                             | Description                          |
+| ----------------- | ---------------------------------------------------------------- | ------------------------------------ |
+| **`paymentData`** | <code><a href="#record">Record</a>&lt;string, unknown&gt;</code> | Payment data returned by Google Pay. |
+
+
+#### PayPaymentOptions
+
+| Prop         | Type                                                                        |
+| ------------ | --------------------------------------------------------------------------- |
+| **`apple`**  | <code><a href="#applepaypaymentoptions">ApplePayPaymentOptions</a></code>   |
+| **`google`** | <code><a href="#googlepaypaymentoptions">GooglePayPaymentOptions</a></code> |
+
+
+#### ApplePayPaymentOptions
+
+| Prop                                | Type                                                                  | Description                                                        |
+| ----------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| **`merchantIdentifier`**            | <code>string</code>                                                   | Merchant identifier created in the Apple Developer portal.         |
+| **`countryCode`**                   | <code>string</code>                                                   | Two-letter ISO 3166 country code.                                  |
+| **`currencyCode`**                  | <code>string</code>                                                   | Three-letter ISO 4217 currency code.                               |
+| **`paymentSummaryItems`**           | <code>ApplePaySummaryItem[]</code>                                    | Payment summary items displayed in the Apple Pay sheet.            |
+| **`supportedNetworks`**             | <code>ApplePayNetwork[]</code>                                        | Card networks to support.                                          |
+| **`merchantCapabilities`**          | <code>ApplePayMerchantCapability[]</code>                             | Merchant payment capabilities. Defaults to ['3DS'] when omitted.   |
+| **`requiredShippingContactFields`** | <code>ApplePayContactField[]</code>                                   | Contact fields that must be supplied for shipping.                 |
+| **`requiredBillingContactFields`**  | <code>ApplePayContactField[]</code>                                   | Contact fields that must be supplied for billing.                  |
+| **`shippingType`**                  | <code><a href="#applepayshippingtype">ApplePayShippingType</a></code> | Controls the shipping flow presented to the user.                  |
+| **`supportedCountries`**            | <code>string[]</code>                                                 | Optional ISO 3166 country codes where the merchant is supported.   |
+| **`applicationData`**               | <code>string</code>                                                   | Optional opaque application data passed back in the payment token. |
+
+
+#### ApplePaySummaryItem
+
+| Prop         | Type                                                                        |
+| ------------ | --------------------------------------------------------------------------- |
+| **`label`**  | <code>string</code>                                                         |
+| **`amount`** | <code>string</code>                                                         |
+| **`type`**   | <code><a href="#applepaysummaryitemtype">ApplePaySummaryItemType</a></code> |
+
+
+#### GooglePayPaymentOptions
+
+| Prop                     | Type                                                                  | Description                                                                                                                              |
+| ------------------------ | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| **`environment`**        | <code><a href="#googlepayenvironment">GooglePayEnvironment</a></code> | Environment used to construct the Google Payments client. Defaults to `'test'`.                                                          |
+| **`paymentDataRequest`** | <code><a href="#record">Record</a>&lt;string, unknown&gt;</code>      | Raw `PaymentDataRequest` JSON as defined by the Google Pay API. Provide transaction details, merchant info, and tokenization parameters. |
+
+
+### Type Aliases
+
+
+#### PayPlatform
+
+<code>'ios' | 'android' | 'web'</code>
+
+
+#### ApplePayNetwork
+
+<code>'amex' | 'chinaUnionPay' | 'discover' | 'eftpos' | 'electron' | 'girocard' | 'interac' | 'jcb' | 'mada' | 'maestro' | 'masterCard' | 'privateLabel' | 'quicPay' | 'suica' | 'visa' | 'vPay' | 'id' | 'cartesBancaires'</code>
+
+
+#### GooglePayEnvironment
+
+<code>'test' | 'production'</code>
+
+
+#### Record
+
+Construct a type with a set of properties K of type T
+
+<code>{
 [P in K]: T;
 }</code>
+
+
+#### Exclude
+
+<a href="#exclude">Exclude</a> from T those types that are assignable to U
+
+<code>T extends U ? never : T</code>
+
+
+#### ApplePaySummaryItemType
+
+<code>'final' | 'pending'</code>
+
+
+#### ApplePayMerchantCapability
+
+<code>'3DS' | 'credit' | 'debit' | 'emv'</code>
+
+
+#### ApplePayContactField
+
+<code>'emailAddress' | 'name' | 'phoneNumber' | 'postalAddress'</code>
+
+
+#### ApplePayShippingType
+
+<code>'shipping' | 'delivery' | 'servicePickup' | 'storePickup'</code>
+
+</docgen-api>

package/android/build.gradle

@@ -0,0 +1,59 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.7.2'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace "app.capgo.pay"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "com.google.android.gms:play-services-wallet:19.2.0"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>