@capacitor-pay/core

Provider-agnostic payments layer for Capacitor apps, in the spirit of Omnipay for PHP: one package per payment provider, sharing a common set of types and a small registry to load whichever provider you need.

This package on its own only ships shared TypeScript types (CheckoutOptions, CheckoutResult, TapToPayStatus, PaymentMethod, PaymentProviderName) and a createPaymentProvider() factory. The actual native iOS/Android code lives in provider packages, e.g. @capacitor-pay/sumup.

Install

npm install @capacitor-pay/core @capacitor-pay/sumup
npx cap sync

Usage

import { createPaymentProvider } from '@capacitor-pay/core'

const sumup = await createPaymentProvider('sumup')

await sumup.setup({ affiliateKey: 'YOUR_AFFILIATE_KEY' })
await sumup.login({ accessToken: 'OAUTH_ACCESS_TOKEN' })

await sumup.checkout({
  amount: 12.5,
  currency: 'EUR',
  title: 'Order #1234',
})

Adding a provider

Each provider is its own npm package (e.g. @capacitor-pay/sumup) implementing checkout, logout, checkTapToPay and activateTapToPay against the shared CheckoutOptions/TapToPayStatus types from this package, plus whatever setup/login shape it needs. To wire a new provider into createPaymentProvider, add a case to src/providers.ts that lazily imports the provider package.

Note on the provider dependencies

While @capacitor-pay/sumup, @capacitor-pay/stripe and @capacitor-pay/adyen are unpublished, this package depends on them via file:../capacitor-pay-* (i.e. sibling directories). Once published to npm, update those to normal semver ranges.