更新记录

1.0.4（2026-06-03）

支持可选启用 Apple Pay / Google Pay

1.0.3（2026-06-03）

修复已知问题

1.0.2（2026-05-26）

修复 uni-app项目 安卓平台无法收到支付回调的问题

平台兼容性

uni-app(4.87)

uni-app x(4.87)

tt-stripe-pay

uni-app / uni-app x 的 Stripe PaymentSheet 插件：在 iOS、Android App 内调起原生收银台。需服务端创建 PaymentIntent 并下发 client_secret。

1. 接入前必读

1. 服务端必须用 Secret Key 创建 PaymentIntent，再把 client_secret 和 Publishable Key 下发给 App。
2. client_secret 和 Publishable Key 必须属于同一 Stripe 账号和同一环境（test / live）。
3. 含 Stripe 原生依赖时，请使用自定义基座或正式包测试；不要用未集成本插件的标准基座。
4. success 只表示客户端 PaymentSheet 流程完成；最终支付状态以服务端查询 PaymentIntent 或 Webhook 为准。
5. Apple Pay / Google Pay 默认关闭；不传 applePay / googlePay 就是普通 PaymentSheet。

2. iOS：外跳回 App（returnURL）

启用会跳出 App 的支付方式时，建议配置自定义 URL Scheme，并传入同 scheme 的 returnURL：

1. 在 utssdk/app-ios/Info.plist 配置 CFBundleURLSchemes。
2. 调用时传入完整 returnURL，如 myapp://stripe-redirect。
3. 挂载 TTStripePayHookProxy，把 iOS open URL 回调交给 Stripe。

只测不外跳的卡支付时，returnURL 可不传。

3. Apple Pay / Google Pay（可选）

iOS：启用 Apple Pay

启用前需要：

1. 在 Apple Developer 创建 Merchant ID，如 merchant.com.example.app。
2. 为 App ID 启用 Apple Pay，并关联该 Merchant ID。
3. 在 Stripe Dashboard 配置 Apple Pay iOS certificate。
4. 复制 utssdk/app-ios/UTS.entitlements.example 为 utssdk/app-ios/UTS.entitlements，把 merchant.com.example.app 改为你的 Merchant ID。
5. 调用 presentPaymentSheet 时传入同一个 merchantId。

applePay.merchantCountryCode 是商户业务国家/地区代码，不是用户所在地。

UTS.entitlements 示例：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.developer.in-app-payments</key>
    <array>
        <string>merchant.com.example.app</string>
    </array>
</dict>
</plist>

不需要 Apple Pay 时，不要创建 UTS.entitlements，或不要包含 com.apple.developer.in-app-payments。可以保留有效的空 plist，但不要保留零字节空文件。

Android：启用 Google Pay

插件已声明 Google Pay API：

<meta-data
    android:name="com.google.android.gms.wallet.api.enabled"
    android:value="true" />

调用时传入 googlePay 即可启用。测试环境设置 testEnv: true。不使用 Google Pay 时不需要删除上面的 meta-data；只要不传 googlePay，插件不会启用 Google Pay。

googlePay.merchantCountryCode 是商户业务国家/地区代码。currencyCode 对 PaymentIntent 可选但建议传，对 SetupIntent 必填。Google Pay 需在支持地区用 Android 真机测试，并登录已配置 Google Wallet 的账号。

4. 代码示例

// #ifdef APP-ANDROID || APP-IOS
import { getTTStripePay } from '@/uni_modules/tt-stripe-pay';
// #endif

const stripePay = getTTStripePay();

stripePay.presentPaymentSheet({
    publishableKey: 'pk_test_xxx',
    paymentIntentClientSecret: 'pi_xxx_secret_xxx',
    merchantDisplayName: '我的商户',
    returnURL: 'myapp://stripe-redirect',
    customerId: 'cus_xxx',
    customerEphemeralKeySecret: 'ek_test_xxx',
    // #ifdef APP-IOS
    applePay: {
        merchantId: 'merchant.com.example.app',
        merchantCountryCode: 'US',
    },
    // #endif
    // #ifdef APP-ANDROID
    googlePay: {
        merchantCountryCode: 'US',
        currencyCode: 'USD',
        testEnv: true,
    },
    // #endif
    success: () => {
        /* 建议服务端再查 PaymentIntent */
    },
    fail: (err) => {
        console.error(err.errCode, err.errMsg);
    },
    complete: null,
});

类型见 utssdk/interface.uts。

5. API：presentPaymentSheet

applePay

googlePay

6. 演示联调（可选）

Stripe 官方示例后端：

• POST https://stripe-mobile-payment-sheet.stripedemos.com/checkout
• 响应含 publishableKey、paymentIntent、customer、ephemeralKey。
• 演示 returnURL 为 payments-example://stripe-redirect，iOS 需保留或追加 payments-example scheme。
• 该接口不下发 Apple Pay / Google Pay 配置；钱包测试需手动填写参数。

tt-stripe-demo 内「拉取官方演示数据」可一键填入。

7. 错误码（errSubject: TTStripePay）

8. 常见问题