跳过主要内容

支付 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支付 以获取@capgo/capacitor-pay的实现细节 开始使用 了解开始使用的详细信息 Capgo 付款方案 了解Capgo 付款方案中的产品流程 付款系统 了解付款系统的详细信息,并 @capgo/原生购买 了解@capgo/native-purchases的详细信息。

常见问题

支付插件常见问题

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

运行 "bun add @capgo/capacitor-pay" (或 "npm install @capgo/capacitor-pay" ),然后运行 "bunx cap sync" 以便 iOS 和 Android 项目捕获本地 code。从 "@capgo/capacitor-pay" 中导入它,然后在应用中使用 code。

Does @capgo/capacitor-pay work with React, Vue and Angular?

是。Pay 是一个 Capacitor 包,因此它支持任何运行在 Capacitor 内的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

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

Capgo 插件遵循 Capacitor 的主要版本:使用与 Capacitor 主要版本匹配的插件版本(例如插件 v8 与 Capacitor 8)。兼容性表格在 GitHub README 中列出维护版本。

是否 @capgo/capacitor-pay 免费和开源?

是。源码 code 在 GitHub 上公开,https://github.com/Cap-go/capacitor-pay/,并且可以从 npm 免费安装。欢迎bug报告和pull请求。

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

安装或升级插件会改变本机 code,因此需要新建一个商店构建。之后,JavaScript、HTML 和 CSS 调用插件的更改可以立即通过 Capgo 实时更新。

在应用商店中发布插件后,Ship Pay 即可立即更新,不需要等待应用程序审查。

一旦插件在您的应用商店中发布,Capgo 即可立即更新您的 JavaScript、HTML 和 CSS 更改,仅需几分钟。

开始使用 Capgo