快速入门

复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-stripe-pay`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/stripe-pay/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

安装

bun add @capgo/capacitor-stripe-pay
bunx cap sync

导入

import { Stripe } from '@capgo/capacitor-stripe-pay';

快速入门

import { Stripe } from '@capgo/capacitor-stripe-pay';

await Stripe.initialize({ publishableKey: 'publishable-key-123' });

示例：handleURLCallback

import { Stripe } from '@capgo/capacitor-stripe-pay';

await Stripe.handleURLCallback({ url: 'https://example.com' });

常见坑点

初始化一次: 在应用启动时运行 setup。
原生同步：运行 bunx cap sync 在插件升级后。
唯一可信来源：信任 src/definitions.ts 在 GitHub 仓库中。

订阅与应用内购买

若需处理 App Store / Play Store 的订阅与权限，请使用 @capgo/native-purchases 而非此插件。

Payment Sheet 流程

await Stripe.initialize({ publishableKey: 'pk_test_...' });

await Stripe.createPaymentSheet({
  paymentIntentClientSecret: 'pi_..._secret_...',
  merchantDisplayName: 'My Store',
});

const result = await Stripe.presentPaymentSheet();

直接收费（Stripe Connect）

传入 stripeAccount 开启 initialize() 或每 createPaymentSheet() 在关联账户上创建 PaymentIntents 时。

示例应用

git clone https://github.com/Cap-go/capacitor-stripe-pay.git
cd capacitor-stripe-pay/example-app
bun install
bun run start

单一事实来源

本页记录了当前公开的 API，来自 Capgo/capacitor-stripe-pay.