@gmisoftware/react-native-pay 0.0.12 → 0.0.14

package/nitrogen/generated/shared/c++/PaymentRequest.hpp

@@ -2,7 +2,7 @@
 /// PaymentRequest.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once
@@ -41,7 +41,7 @@ namespace margelo::nitro::pay {
    */
   struct PaymentRequest {
   public:
-    std::string merchantIdentifier     SWIFT_PRIVATE;
+    std::optional<std::string> applePayMerchantIdentifier     SWIFT_PRIVATE;
     std::optional<std::string> merchantName     SWIFT_PRIVATE;
     std::string countryCode     SWIFT_PRIVATE;
     std::string currencyCode     SWIFT_PRIVATE;
@@ -52,13 +52,14 @@ namespace margelo::nitro::pay {
     std::optional<std::vector<PaymentItem>> shippingMethods     SWIFT_PRIVATE;
     std::optional<bool> billingContactRequired     SWIFT_PRIVATE;
     std::optional<bool> shippingContactRequired     SWIFT_PRIVATE;
+    std::optional<std::string> googlePayMerchantId     SWIFT_PRIVATE;
     std::optional<GooglePayEnvironment> googlePayEnvironment     SWIFT_PRIVATE;
     std::optional<std::string> googlePayGateway     SWIFT_PRIVATE;
     std::optional<std::string> googlePayGatewayMerchantId     SWIFT_PRIVATE;
 
   public:
     PaymentRequest() = default;
-    explicit PaymentRequest(std::string merchantIdentifier, std::optional<std::string> merchantName, std::string countryCode, std::string currencyCode, std::vector<PaymentItem> paymentItems, std::vector<std::string> merchantCapabilities, std::vector<std::string> supportedNetworks, std::optional<std::string> shippingType, std::optional<std::vector<PaymentItem>> shippingMethods, std::optional<bool> billingContactRequired, std::optional<bool> shippingContactRequired, std::optional<GooglePayEnvironment> googlePayEnvironment, std::optional<std::string> googlePayGateway, std::optional<std::string> googlePayGatewayMerchantId): merchantIdentifier(merchantIdentifier), merchantName(merchantName), countryCode(countryCode), currencyCode(currencyCode), paymentItems(paymentItems), merchantCapabilities(merchantCapabilities), supportedNetworks(supportedNetworks), shippingType(shippingType), shippingMethods(shippingMethods), billingContactRequired(billingContactRequired), shippingContactRequired(shippingContactRequired), googlePayEnvironment(googlePayEnvironment), googlePayGateway(googlePayGateway), googlePayGatewayMerchantId(googlePayGatewayMerchantId) {}
+    explicit PaymentRequest(std::optional<std::string> applePayMerchantIdentifier, std::optional<std::string> merchantName, std::string countryCode, std::string currencyCode, std::vector<PaymentItem> paymentItems, std::vector<std::string> merchantCapabilities, std::vector<std::string> supportedNetworks, std::optional<std::string> shippingType, std::optional<std::vector<PaymentItem>> shippingMethods, std::optional<bool> billingContactRequired, std::optional<bool> shippingContactRequired, std::optional<std::string> googlePayMerchantId, std::optional<GooglePayEnvironment> googlePayEnvironment, std::optional<std::string> googlePayGateway, std::optional<std::string> googlePayGatewayMerchantId): applePayMerchantIdentifier(applePayMerchantIdentifier), merchantName(merchantName), countryCode(countryCode), currencyCode(currencyCode), paymentItems(paymentItems), merchantCapabilities(merchantCapabilities), supportedNetworks(supportedNetworks), shippingType(shippingType), shippingMethods(shippingMethods), billingContactRequired(billingContactRequired), shippingContactRequired(shippingContactRequired), googlePayMerchantId(googlePayMerchantId), googlePayEnvironment(googlePayEnvironment), googlePayGateway(googlePayGateway), googlePayGatewayMerchantId(googlePayGatewayMerchantId) {}
   };
 
 } // namespace margelo::nitro::pay
@@ -71,7 +72,7 @@ namespace margelo::nitro {
     static inline margelo::nitro::pay::PaymentRequest fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
       jsi::Object obj = arg.asObject(runtime);
       return margelo::nitro::pay::PaymentRequest(
-        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "merchantIdentifier")),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "applePayMerchantIdentifier")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "merchantName")),
         JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "countryCode")),
         JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "currencyCode")),
@@ -82,6 +83,7 @@ namespace margelo::nitro {
         JSIConverter<std::optional<std::vector<margelo::nitro::pay::PaymentItem>>>::fromJSI(runtime, obj.getProperty(runtime, "shippingMethods")),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "billingContactRequired")),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "shippingContactRequired")),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "googlePayMerchantId")),
         JSIConverter<std::optional<margelo::nitro::pay::GooglePayEnvironment>>::fromJSI(runtime, obj.getProperty(runtime, "googlePayEnvironment")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "googlePayGateway")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "googlePayGatewayMerchantId"))
@@ -89,7 +91,7 @@ namespace margelo::nitro {
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::pay::PaymentRequest& arg) {
       jsi::Object obj(runtime);
-      obj.setProperty(runtime, "merchantIdentifier", JSIConverter<std::string>::toJSI(runtime, arg.merchantIdentifier));
+      obj.setProperty(runtime, "applePayMerchantIdentifier", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.applePayMerchantIdentifier));
       obj.setProperty(runtime, "merchantName", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.merchantName));
       obj.setProperty(runtime, "countryCode", JSIConverter<std::string>::toJSI(runtime, arg.countryCode));
       obj.setProperty(runtime, "currencyCode", JSIConverter<std::string>::toJSI(runtime, arg.currencyCode));
@@ -100,6 +102,7 @@ namespace margelo::nitro {
       obj.setProperty(runtime, "shippingMethods", JSIConverter<std::optional<std::vector<margelo::nitro::pay::PaymentItem>>>::toJSI(runtime, arg.shippingMethods));
       obj.setProperty(runtime, "billingContactRequired", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.billingContactRequired));
       obj.setProperty(runtime, "shippingContactRequired", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.shippingContactRequired));
+      obj.setProperty(runtime, "googlePayMerchantId", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.googlePayMerchantId));
       obj.setProperty(runtime, "googlePayEnvironment", JSIConverter<std::optional<margelo::nitro::pay::GooglePayEnvironment>>::toJSI(runtime, arg.googlePayEnvironment));
       obj.setProperty(runtime, "googlePayGateway", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.googlePayGateway));
       obj.setProperty(runtime, "googlePayGatewayMerchantId", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.googlePayGatewayMerchantId));
@@ -113,7 +116,7 @@ namespace margelo::nitro {
       if (!nitro::isPlainObject(runtime, obj)) {
         return false;
       }
-      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "merchantIdentifier"))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "applePayMerchantIdentifier"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "merchantName"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "countryCode"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "currencyCode"))) return false;
@@ -124,6 +127,7 @@ namespace margelo::nitro {
       if (!JSIConverter<std::optional<std::vector<margelo::nitro::pay::PaymentItem>>>::canConvert(runtime, obj.getProperty(runtime, "shippingMethods"))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "billingContactRequired"))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "shippingContactRequired"))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "googlePayMerchantId"))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::pay::GooglePayEnvironment>>::canConvert(runtime, obj.getProperty(runtime, "googlePayEnvironment"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "googlePayGateway"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "googlePayGatewayMerchantId"))) return false;

package/nitrogen/generated/shared/c++/PaymentResult.hpp

@@ -2,7 +2,7 @@
 /// PaymentResult.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/nitrogen/generated/shared/c++/PaymentToken.hpp

@@ -2,7 +2,7 @@
 /// PaymentToken.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/nitrogen/generated/shared/c++/views/HybridApplePayButtonComponent.cpp

@@ -2,7 +2,7 @@
 /// HybridApplePayButtonComponent.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridApplePayButtonComponent.hpp"

package/nitrogen/generated/shared/c++/views/HybridApplePayButtonComponent.hpp

@@ -2,7 +2,7 @@
 /// HybridApplePayButtonComponent.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/nitrogen/generated/shared/c++/views/HybridGooglePayButtonComponent.cpp

@@ -2,7 +2,7 @@
 /// HybridGooglePayButtonComponent.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridGooglePayButtonComponent.hpp"

package/nitrogen/generated/shared/c++/views/HybridGooglePayButtonComponent.hpp

@@ -2,7 +2,7 @@
 /// HybridGooglePayButtonComponent.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmisoftware/react-native-pay",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "author": "gmi.software",
   "repository": {
     "type": "git",
@@ -10,15 +10,19 @@
   "module": "lib/index",
   "devDependencies": {
     "@react-native/eslint-config": "0.82.0",
-    "@types/jest": "^29.5.12",
+    "@testing-library/react-native": "^13.3.3",
+    "@types/jest": "^30.0.0",
     "@types/react": "^19.1.03",
+    "babel-jest": "^30.2.0",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.2.1",
+    "jest": "^30.2.0",
     "nitrogen": "*",
     "prettier": "^3.3.3",
-    "typescript": "^5.8.3",
-    "release-it": "^19.0.0"
+    "react-test-renderer": "19.1.0",
+    "release-it": "^19.0.0",
+    "typescript": "^5.8.3"
   },
   "peerDependencies": {
     "react": "*",
@@ -39,6 +43,16 @@
     "plugins": [
       "prettier"
     ],
+    "overrides": [
+      {
+        "files": [
+          "jest.setup.js"
+        ],
+        "env": {
+          "jest": true
+        }
+      }
+    ],
     "rules": {
       "prettier/prettier": [
         "warn",
@@ -105,6 +119,9 @@
     "postpack": "rm ./README.md",
     "postinstall": "tsc || exit 0;",
     "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:ci": "jest --runInBand --ci",
     "clean": "rm -rf android/build node_modules/**/android/build lib",
     "lint": "eslint \"**/*.{js,ts,tsx}\" --fix",
     "lint-ci": "eslint \"**/*.{js,ts,tsx}\" -f @jamesacarr/github-actions",

package/src/hooks/__tests__/usePaymentCheckout.integration.test.ts

@@ -0,0 +1,248 @@
+import { act, renderHook, waitFor } from '@testing-library/react-native'
+
+const mockPayServiceStatus = jest.fn()
+const mockStartPayment = jest.fn()
+
+jest.mock('react-native-nitro-modules', () => ({
+  NitroModules: {
+    createHybridObject: jest.fn(() => ({
+      payServiceStatus: (...args: any[]) => mockPayServiceStatus(...args),
+      startPayment: (...args: any[]) => mockStartPayment(...args),
+    })),
+  },
+}))
+
+import { usePaymentCheckout } from '../usePaymentCheckout'
+
+describe('usePaymentCheckout integration', () => {
+  beforeEach(() => {
+    mockPayServiceStatus.mockReturnValue({
+      canMakePayments: true,
+      canSetupCards: true,
+    })
+    mockStartPayment.mockReset()
+  })
+
+  const renderCheckout = () => renderHook(() => usePaymentCheckout({}))
+
+  it('loads payment service status on mount', async () => {
+    const { result } = renderCheckout()
+
+    await waitFor(() => {
+      expect(result.current.isCheckingStatus).toBe(false)
+    })
+
+    expect(result.current.canMakePayments).toBe(true)
+    expect(result.current.canSetupCards).toBe(true)
+  })
+
+  it('falls back to unavailable status when status check fails', async () => {
+    mockPayServiceStatus.mockImplementationOnce(() => {
+      throw new Error('Native status failure')
+    })
+    const consoleSpy = jest.spyOn(console, 'error').mockImplementation(() => {})
+
+    const { result } = renderCheckout()
+
+    await waitFor(() => {
+      expect(result.current.isCheckingStatus).toBe(false)
+    })
+
+    expect(result.current.canMakePayments).toBe(false)
+    expect(result.current.canSetupCards).toBe(false)
+    expect(consoleSpy).toHaveBeenCalled()
+    consoleSpy.mockRestore()
+  })
+
+  it('manages cart operations and total correctly', async () => {
+    const { result } = renderCheckout()
+
+    await waitFor(() => {
+      expect(result.current.isCheckingStatus).toBe(false)
+    })
+
+    act(() => {
+      result.current.addItem('Coffee', 4.5)
+      result.current.addItems([
+        { label: 'Sandwich', amount: 8.25 },
+        { label: 'Tip', amount: 1.25, type: 'pending' },
+      ])
+    })
+
+    expect(result.current.items).toEqual([
+      { label: 'Coffee', amount: 4.5, type: 'final' },
+      { label: 'Sandwich', amount: 8.25, type: 'final' },
+      { label: 'Tip', amount: 1.25, type: 'pending' },
+    ])
+    expect(result.current.total).toBeCloseTo(14)
+
+    act(() => {
+      result.current.updateItem(0, { amount: 5 })
+    })
+    expect(result.current.items[0]?.amount).toBe(5)
+    expect(result.current.total).toBeCloseTo(14.5)
+
+    act(() => {
+      result.current.removeItem(1)
+    })
+    expect(result.current.items.map((item) => item.label)).toEqual([
+      'Coffee',
+      'Tip',
+    ])
+
+    act(() => {
+      result.current.clearItems()
+    })
+    expect(result.current.items).toEqual([])
+    expect(result.current.total).toBe(0)
+  })
+
+  it('provides default fallback payment item when cart is empty', () => {
+    const { result } = renderCheckout()
+
+    expect(result.current.paymentRequest.paymentItems).toEqual([
+      { label: 'Total', amount: 0, type: 'final' },
+    ])
+    expect(result.current.paymentRequest.countryCode).toBe('US')
+    expect(result.current.paymentRequest.currencyCode).toBe('USD')
+    expect(result.current.paymentRequest).not.toHaveProperty(
+      'applePayMerchantIdentifier'
+    )
+    expect(result.current.paymentRequest).not.toHaveProperty('merchantName')
+    expect(result.current.paymentRequest).not.toHaveProperty(
+      'googlePayMerchantId'
+    )
+  })
+
+  it('rejects startPayment when cart is empty', async () => {
+    const { result } = renderCheckout()
+
+    let paymentResult: any = 'not-called'
+    await act(async () => {
+      paymentResult = await result.current.startPayment()
+    })
+
+    expect(paymentResult).toBeNull()
+    expect(result.current.error?.message).toBe('Cart is empty')
+    expect(mockStartPayment).not.toHaveBeenCalled()
+  })
+
+  it('handles successful payments', async () => {
+    const nativeSuccess = { success: true, transactionId: 'tx_123' }
+    mockStartPayment.mockResolvedValueOnce(nativeSuccess)
+    const { result } = renderCheckout()
+
+    act(() => {
+      result.current.addItem('Coffee', 4.99)
+    })
+
+    let paymentResult: any = null
+    await act(async () => {
+      paymentResult = await result.current.startPayment()
+    })
+
+    expect(mockStartPayment).toHaveBeenCalledTimes(1)
+    expect(mockStartPayment).toHaveBeenCalledWith(
+      expect.objectContaining({
+        paymentItems: [{ label: 'Coffee', amount: 4.99, type: 'final' }],
+      })
+    )
+    expect(paymentResult).toEqual(nativeSuccess)
+    expect(result.current.result).toEqual(nativeSuccess)
+    expect(result.current.error).toBeNull()
+    expect(result.current.isProcessing).toBe(false)
+  })
+
+  it('sets an error when native payment response has success=false', async () => {
+    mockStartPayment.mockResolvedValueOnce({
+      success: false,
+      error: 'Declined by issuer',
+    })
+    const { result } = renderCheckout()
+
+    act(() => {
+      result.current.addItem('Order', 9.99)
+    })
+
+    await act(async () => {
+      await result.current.startPayment()
+    })
+
+    expect(result.current.error?.message).toBe('Declined by issuer')
+    expect(result.current.result).toEqual({
+      success: false,
+      error: 'Declined by issuer',
+    })
+  })
+
+  it('forwards Apple Pay override and Google Pay config when provided', async () => {
+    mockStartPayment.mockResolvedValueOnce({ success: true })
+
+    const { result } = renderHook(() =>
+      usePaymentCheckout({
+        applePayMerchantIdentifier: 'merchant.com.apple.override',
+        googlePayMerchantId: 'google-pay-merchant-id',
+        googlePayEnvironment: 'PRODUCTION',
+        googlePayGateway: 'stripe',
+        googlePayGatewayMerchantId: 'gateway-merchant-id',
+      })
+    )
+
+    act(() => {
+      result.current.addItem('Order', 12)
+    })
+
+    await act(async () => {
+      await result.current.startPayment()
+    })
+
+    expect(mockStartPayment).toHaveBeenCalledWith(
+      expect.objectContaining({
+        applePayMerchantIdentifier: 'merchant.com.apple.override',
+        googlePayMerchantId: 'google-pay-merchant-id',
+        googlePayEnvironment: 'PRODUCTION',
+        googlePayGateway: 'stripe',
+        googlePayGatewayMerchantId: 'gateway-merchant-id',
+      })
+    )
+  })
+
+  it('uses generic error for non-Error thrown values', async () => {
+    mockStartPayment.mockRejectedValueOnce('native crash')
+    const { result } = renderCheckout()
+
+    act(() => {
+      result.current.addItem('Order', 12)
+    })
+
+    let paymentResult: any = 'not-null'
+    await act(async () => {
+      paymentResult = await result.current.startPayment()
+    })
+
+    expect(paymentResult).toBeNull()
+    expect(result.current.error?.message).toBe('Payment processing failed')
+  })
+
+  it('resets transient checkout state', async () => {
+    mockStartPayment.mockResolvedValueOnce({ success: false, error: 'Failed' })
+    const { result } = renderCheckout()
+
+    act(() => {
+      result.current.addItem('Order', 3)
+    })
+    await act(async () => {
+      await result.current.startPayment()
+    })
+
+    expect(result.current.error).not.toBeNull()
+
+    act(() => {
+      result.current.reset()
+    })
+
+    expect(result.current.error).toBeNull()
+    expect(result.current.result).toBeNull()
+    expect(result.current.isProcessing).toBe(false)
+  })
+})

package/src/hooks/usePaymentCheckout.ts

@@ -11,17 +11,73 @@ import type {
   PayServiceStatus,
   GooglePayEnvironment,
 } from '../types'
-import { createPaymentItem, calculateTotal } from '../utils'
+import {
+  createPaymentItem,
+  calculateTotal,
+  sanitizePaymentRequest,
+} from '../utils'
 
+/**
+ * Configuration for `usePaymentCheckout`.
+ */
 export interface UsePaymentCheckoutConfig {
-  merchantIdentifier: string
+  /**
+   * Merchant name shown by payment providers that support displaying it.
+   * Used primarily by Google Pay.
+   */
   merchantName?: string
+
+  /**
+   * ISO 3166-1 alpha-2 country code for the transaction.
+   * Defaults to `'US'`.
+   */
   countryCode?: string
+
+  /**
+   * ISO 4217 currency code for all payment items.
+   * Defaults to `'USD'`.
+   */
   currencyCode?: string
+
+  /**
+   * Supported card networks for the payment sheet.
+   * Defaults to `['visa', 'mastercard', 'amex', 'discover']`.
+   */
   supportedNetworks?: string[]
+
+  /**
+   * Merchant capabilities passed to Apple Pay.
+   * Defaults to `['3DS']`.
+   */
   merchantCapabilities?: string[]
+
+  /**
+   * Optional Apple Pay Merchant ID override.
+   * When omitted, iOS reads the Merchant ID from the app entitlements.
+   */
+  applePayMerchantIdentifier?: string
+
+  /**
+   * Google Pay merchant ID used in Android production requests.
+   * Not needed for iOS.
+   */
+  googlePayMerchantId?: string
+
+  /**
+   * Google Pay environment for Android requests.
+   * Use `'TEST'` for sandbox flows and `'PRODUCTION'` for live payments.
+   */
   googlePayEnvironment?: GooglePayEnvironment
+
+  /**
+   * Payment gateway identifier for Google Pay tokenization.
+   * Examples include `'stripe'`, `'braintree'`, and `'adyen'`.
+   */
   googlePayGateway?: string
+
+  /**
+   * Merchant ID provided by your payment gateway for Google Pay tokenization.
+   */
   googlePayGatewayMerchantId?: string
 }
 
@@ -62,7 +118,8 @@ export interface UsePaymentCheckoutReturn {
  * - Payment processing
  * - State management
  *
- * @param config - Payment configuration
+ * @param config - Hook configuration including locale, supported networks,
+ * Apple Pay override, and Google Pay gateway settings.
  * @returns Complete payment checkout interface
  *
  * @example
@@ -79,9 +136,9 @@ export interface UsePaymentCheckoutReturn {
  *     isProcessing,
  *     error,
  *   } = usePaymentCheckout({
- *     merchantIdentifier: 'merchant.com.example',
  *     currencyCode: 'USD',
  *     countryCode: 'US',
+ *     googlePayMerchantId: 'your_google_pay_merchant_id',
  *   })
  *
  *   // Add single item
@@ -142,30 +199,32 @@ export function usePaymentCheckout(
 
   const paymentRequest = useMemo<PaymentRequest>(() => {
     const {
-      merchantIdentifier,
       merchantName,
       countryCode = 'US',
       currencyCode = 'USD',
       supportedNetworks = ['visa', 'mastercard', 'amex', 'discover'],
       merchantCapabilities = ['3DS'],
+      applePayMerchantIdentifier,
+      googlePayMerchantId,
       googlePayEnvironment,
       googlePayGateway,
       googlePayGatewayMerchantId,
     } = config
 
-    return {
-      merchantIdentifier,
+    return sanitizePaymentRequest({
       countryCode,
-      merchantName,
       currencyCode,
       supportedNetworks,
       merchantCapabilities,
       paymentItems:
         items.length > 0 ? items : [createPaymentItem('Total', 0, 'final')],
+      applePayMerchantIdentifier,
+      merchantName,
+      googlePayMerchantId,
       googlePayEnvironment,
       googlePayGateway,
       googlePayGatewayMerchantId,
-    }
+    })
   }, [config, items])
 
   // Cart operations

package/src/plugin/__tests__/index.test.ts

@@ -0,0 +1,37 @@
+const mockWithGooglePay = jest.fn((config, _props) => ({
+  ...config,
+  googlePay: true,
+}))
+const mockWithApplePay = jest.fn((config, _props) => ({
+  ...config,
+  applePay: true,
+}))
+
+jest.mock('../withGooglePay', () => ({
+  withGooglePay: (config: any, props: any) => mockWithGooglePay(config, props),
+}))
+
+jest.mock('../withApplePay', () => ({
+  withApplePay: (config: any, props: any) => mockWithApplePay(config, props),
+}))
+
+import withReactNativePay from '../index'
+
+describe('withReactNativePay', () => {
+  it('applies Google Pay and Apple Pay plugins in order', () => {
+    const inputConfig = { name: 'my-app' }
+    const props = {
+      merchantIdentifier: 'merchant.com.test',
+      enableGooglePay: true,
+    }
+
+    const result = withReactNativePay(inputConfig as any, props)
+
+    expect(mockWithGooglePay).toHaveBeenCalledWith(inputConfig, props)
+    expect(mockWithApplePay).toHaveBeenCalledWith(
+      { name: 'my-app', googlePay: true },
+      props
+    )
+    expect(result).toEqual({ name: 'my-app', googlePay: true, applePay: true })
+  })
+})