跳转至正文

支付 Capacitor 插件

支持 Apple Pay 和 Google Pay,打造无缝结账体验

安装

bun add @capgo/capacitor-pay bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-pay
  • pnpm add @capgo/capacitor-pay
  • yarn add @capgo/capacitor-pay

指南

如何在 Capacitor 中使用 Pay

使用 @capgo/capacitor-pay

使用 Capacitor 插件触发 iOS (Apple Pay) 和 Android (Google Pay) 的原生支付。

安装

bun add @capgo/capacitor-pay
bunx cap sync

bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。

导入

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

API 概览

方法 描述
isPayAvailable 检查当前平台是否支持原生支付。在 iOS 上会检测 Apple Pay,在 Android 上会检测 Google Pay。
requestPayment 调起当前平台的原生支付界面。在 iOS 上需提供 Apple Pay 配置,在 Android 上需提供 Google Pay 配置。

示例

isPayAvailable()

检查当前平台是否支持原生支付。在 iOS 上会检测 Apple Pay,在 Android 上会检测 Google Pay。

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

const result = await Pay.isPayAvailable();
console.log(result);

requestPayment()

调起当前平台的原生支付界面。在 iOS 上需提供 Apple Pay 配置,在 Android 上需提供 Google Pay 配置。

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

const result = await Pay.requestPayment({
  apple: {
    merchantIdentifier: 'merchant-identifier-123',
    countryCode: 'US',
    currencyCode: 'USD',
    paymentSummaryItems: [
      {
        label: 'Hello from Capacitor',
        amount: 'amount',
      },
    ],
    supportedNetworks: ['AmEx'],
  },
});
// The result holds sensitive values: use it without logging it.

完整参考文档

继续使用 @capgo/capacitor-pay

如果你正在使用 使用 @capgo/capacitor-pay 要规划付款和购买,请将其与 @capgo/capacitor-pay 了解 @capgo/capacitor-pay 中的实现细节, 快速入门 有关“入门指南”中的实现细节, Capgo 定价 关于 Capgo 定价中的产品工作流, 支付系统 关于支付系统中的实现细节,以及 @capgo/native-purchases 了解 @capgo/native-purchases. 的实现细节

常见问题

Pay 插件常见问题

如何在 Capacitor 应用中安装 Pay 插件?

运行 "bun add @capgo/capacitor-pay"(或 "npm install @capgo/capacitor-pay"),然后运行 "bunx cap sync",使 iOS 和 Android 项目同步原生 code。最后在你的应用 code 中从 "@capgo/capacitor-pay" 导入即可。

@capgo/capacitor-pay 是否支持 React、Vue 和 Angular?

支持。Pay 是一个 Capacitor 包,因此它可以与任何在 Capacitor 中运行的 Web 框架配合使用,包括 Ionic、React、Vue、Angular、Svelte 以及原生 JavaScript。

@capgo/capacitor-pay 支持哪个版本的 Capacitor?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-pay 是免费开源的吗?

是的。code 源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-pay/,且可以通过 npm 免费安装。欢迎提交 Bug 反馈和 Pull Request。

我可以在不经过 App Store 审核的情况下更新使用了 Pay 的 code 吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待应用审核,即可快速发布支付功能更新

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo