特征

• 提供无缝集成
• QQ通用解决方案( Apple 钱包和 Google 钱包)
• QQ 直接从您的应用程序中轻松安全地添加支付卡
• * 支持签证、万事达卡、Amex和发现支付卡
• UAPP(统一Android Push Production)支持加强安全
• QQ 博览会支持( expo- plugin)

开始

使用 react-native-wallet Push提供功能需要Google和Apple进行适当的配置和访问. 在安装库前请遵循以下指示 :

机器人

要与Google钱包在Android上互动,请确保完成以下所有步骤: google Push 提供文档数字 :

第1步:进入Google TapAndPay SDK

1. 访问 google Pay Android Push 提供 API 文件 并请求访问它.

2. 一旦得到谷歌团队的批准

   1. 下载 磁带Pay SDK. 库使用UAPP APIs(PaymentCredentialsGenerator, (中文(简体) ), PushTokenizeResult),所以没有这些版本的更古老的SDK版本将无法编译. 以 18.10.1 试验.
   2. 解开并取出SDK /android/libs 在您的 React 原生项目中的文件夹( 如果没有) libs 文件夹,创建一个).
   3. 添加 /android/libs 改为 .gitignore。 。 。 .

3. 然后连接 SDK 到您的工程 build.gradle,例如,在 实例/机器人/建造.gradle数字 :

allprojects {
    repositories {
        google()
        maven { url "file://${rootDir}/libs" }
    }
}

第二步:将您的应用程序白列一等,供SDK使用.

要在您的应用中使用Google SDK, 您需要将您的应用细节白名单 。 没有它,调用一些功能将导致 Not verified 错误. 为了解决问题,请遵照我的指示 官方 Google 文档。 。 。 .

为了你的建筑,你需要准备你的应用软件 package name 财务报告和审定财务报表 fingerprint 如下 这些步骤例如,这些价值应该是这样的:

Package name: com.app.package.name

Fingerprint: SHA256: 36:38:63:59:6E:...:00:82:16:4E:FF

[TIP] 您可以使用 SHA-256 证书校验和 apksigner 或者说 keytool。 。 。 .

以所有需要的数据提交表格并等待Google的回应. 成功将您的应用程序白化后, 您将可以在我们的库中使用 Google SDK .

iOS系统

步骤1:申请适当的应享权利

为了在您的应用程序中启用 In-App Proference, 您必须请求激活您的开发者团队ID 的 Apple Pay 应享权利 。 企业队身份证明不支持. 在我们的面板中默认无法提供此项权利;您需要请求.

通过 请求提供材料。只有账户持有者才能访问此表格——如果无法访问,请与团队账户持有者协调。 或者,您可以发电子邮件 [email protected] 格式如下:

主题 : Apple Pay Entitlements and Allow List Request - [Issuer Name] - [Country Code]

车身 :

• 发行者名称
• 国家[国家代码]
• 团队标识
• 亚当身份证
• 应用程序名称

[注] 只有制作团队的身份证和亚当的身份证才能获得该资格. 测试组的ID不合格.

一旦苹果验证你的身份, 你应该得到文件命名 Getting Started with Apple Pay In-App Provisioning, Verification & Security在此机密文件中,您将找到与下列事项有关的所有相关信息:

• 您的项目的前提条件
• 应遵循的最佳做法
• 内部辅助提供如何运作
• UX 要求
• 测试过程
• 还有...

在应用您的应用程序前, 请先熟悉该文件 .

步骤2:启动权利

在得到苹果公司的积极回应后,打开开发者门户网站面板并搜索 Certificates, Identifiers & Profiles - > (中文) Profiles - > (中文) Our distribution profile - > (中文) Edit 并添加 ApplePay In-App Provisioning Distribution 权利. 您必须使用物理设备和卡片.

步骤3:在项目中添加应享权利

添加 com.apple.developer.payment-pass-provisioning 有权享受您的项目。 查找或创建 .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>
    ...
     <!-- In-App Provisioning special entitlement-->
    <key>com.apple.developer.payment-pass-provisioning</key>
    <true/>
</dict>
</plist>

安装

在完成上面一节的设置后,安装 react-native-wallet npm 软件包 :

npm install @expensify/react-native-wallet

或者说

yarn add @expensify/react-native-wallet

博览插件

用于 @expensify/react-native-wallet 与博览会,你需要使用博览会插座.

在你身边 app.json 文件,添加以下配置:

{
  "expo": {
    "plugins": [
      [
            "@expensify/react-native-wallet",
            {
                enableApplePayProvisioning: true,
                googleTapAndPaySdkPath: "./libs/tapandpay-v18.10.1.zip", // path to the Google Tap & Pay SDK zip file
            },
      ],
    ]
  }
}

之后您需要重建您的应用程序, 因为 lib有本地文件 .

npx expo prebuild --clean
npx expo run:ios
npx expo run:android

所需数据

您可以在这里找到库中使用的数据元素, 这是与 Google 钱包和 Apple 钱包 API 合作的关键 .

机器人

• 不透明支付卡 (OPC) - 一个二进制的Google Pay从发行方的app收到信息,可以提交TSP接收一个指使.
• 谷歌不透明支付卡 (Google OPC) - UAPP(统一Android Push Productioning)流所需要OPC的加密版本. 这是您在供给过程中使用谷歌加密密钥的后端生成的. 了解更多关于UAPP的信息
• 托肯服务提供人 (TSP)-一种服务,通过在交易中将信用卡号码替换为独特的数字标识-符号来增强支付安全. TSP指定了用于创建给定代号的代号服务,例如Visa, MasterCard, American Express.
• 托肯引用编号 - 一个独特的识别号码,用于指代一个DPAN(动态个人账户号码)。 Token提供商将在发证时为每个DPAN指定一个发证人代号ID.

iOS系统

• 诺斯 - 苹果公司服务器产生的一次性非ce值。 此非ce必须包含在附加付款请求的加密数据中.
• 非签名 - 非ce设备专用签名。 此签名必须包含在附加付款请求的加密数据中 .
• 证书 - 一系列NSData对象。 每个对象包含一个编码为X.509的DER证书,其中叶子为先,根为后. 您必须下载根 CA 以验证整个链条 .
• 加密的通过数据- 一个加密的JSON文件,其中包含在Apple Pay中添加一卡所需的敏感信息(Base 64被编码). 更多细节在这里.
• 电子公钥 - 椭圆曲线密码学(ECC)(Base 64编码)所使用的密钥.
• 主账户标识符 - PassKit使用不透明的发卡人ID(也叫FPANID)在再发和装置上识别同一张卡. 传过来 IOSCardData 转至 canAddCardToAppleWallet。 。 。 . getCardStatusByIdentifier 与该值完全匹配,并且不回落. addCardToAppleWallet,推断 deviceType,以及 canAddCardToAppleWallet 当你也经过时 lastDigits 共享一个查询:一个精确的 id 匹配胜出, 否则库会使用唯一没有的密码的 id deactivated 和最后一个数字相同。 仍然在运行并用同位数结尾的不同牌可以被取出. 传出存储在通行证上的id PassKit( primaryAccountIdentifier 从 listAppleWalletPasses) 跳过这个检查.
• 设备类型 - 所提供卡片的装置: phone 或者说 watch。PassKit不报告用户选择的设备,所以库推断它来自已经提供卡片的地方。 当它无法分辨时,值是 unknown。 。 。 .

API 参考

库为苹果钱包和Google钱包API的无缝集成和使用提供功能. 此外,它还包括管理供应活动的听众和管理人员。 下文介绍这些功能以及所涉及的数据类型.

职能

打破变革

addCardToAppleWallet 决定 IOSAddCardResult 改为 TokenizationStatus读取 result.status。 。 。 .

钱包的下降解决了 { status: 'error', errorDomain, errorCode } 而不是拒绝。 发行者步骤解决后取消 { status: 'canceled' } 而不是拒绝。 发行者回调时所抛出的错误仍然拒绝,添加支付通行证表关闭 .

数据类型

AndroidCardData 可选字段

这个 AndroidCardData 类型包括两个可选的布尔字段,这些字段提供了关于所提供卡片的额外信息:

isVirtualCard?: boolean

表示所提供的卡片是否是虚拟卡片. 虚拟卡是数字生成的与物理卡账户相连接的卡号. 它们通过以下方式加强安全:

• 允许用户在线购买而不暴露其实体卡号
• 方便注销和再生而不影响物理卡
• 提供交易专用或商家专用卡号

设定为 true,此旗帜告知谷歌钱包,所提供卡片是虚拟卡片,这可能会影响卡片在钱包界面中如何显示和管理.

isBounceProvisioned?: boolean

说明卡片是否通过"弹出提供"提供. 弹出提供是两步提供流程,其中:

1. 用户最初直接通过 Google 钱包( 在您的应用程序之外) 提供一张卡片
2. 您的应用程序稍后“ 弹出” 或引导用户返回以完成额外的校验或设置步骤

此旗能帮助Google Walet轨道卡最初通过Google Waletapp添加,但需要额外的应用特定配置或验证. 设定为 true,它表示此卡以前通过Google钱包接口提供,现在正在通过您的应用程序完成或更新.

卡片状态

听众

构成部分

AddToWalletButton

即用组件简化了Google钱包和Apple钱包增加的支付卡. 按钮会根据指定的平台和语言自动调整其外观. 它使用由下列机构提供的官方资产: 谷歌 财务报告和审定财务报表 苹果公司 在他们的钱包相关品牌指南.

[大 请记住: 谷歌 财务报告和审定财务报表 苹果公司 在应用程序中添加此组件时.

遵守这些准则不仅对遵守法律要求至关重要,而且对使用户确信您的应用程序的真实性和安全也至关重要.

[注] 本地化由系统设置自动处理,确保按钮语言与设备首选语言相匹配.

用法示例:

<AddToWalletButton
    onPress={() => console.log('Button pressed!')}
    style={styles.longButton}
    buttonStyle="blackOutline"
    buttonType="badge"
    borderRadius={4}
/>

机器人	iOS系统

十六进制编码

这个库使用基础64编码来编码数据. 你可能用Hex编码.

如果情况如此,您需要以适当的格式转换数据.

这是一个如何将数据转换成六进制格式的例子 :

import { Buffer } from "buffer"
const base64ToHex = (base64: string): string => Buffer.from(base64, "base64").toString("hex")

[...]

    const issuerEncryptPayloadCallback = async (
        nonce: string,
        nonceSignature: string,
        certificate: string[],
        deviceType: IOSDeviceType,
    ): Promise<IOSEncryptPayload> => {
        try {
            const payload = {
                encryptionDetails: {
                    nonce: base64ToHex(nonce),
                    nonceSignature: base64ToHex(nonceSignature),
                    wspCertificates: certificate,
                },
                deviceType,
                serialNumber,
                wspId: "APPLE" as const,
            }
[...]

这将取决于您的后端/ 签发器的操作情况, 以确保检查它们, 否则监督办可能无法提供卡片 .

UAPP( 统一的Android Push 提供)

对于需要增强卡片提供安全性的Android应用程序,这个库支持UAPP(统一Android Push Productioning)与Google钱包相通.

📖 读取UAPP完整的文档 ~

UAPP指南涵盖:

• UAPP是什么,如何运作
• 分步设置指令
• 后端执行要求
• 处理和排除出错
• 完整代码示例

发布您的应用程序

要成功发布您的应用程序,您需要浏览两个平台的一系列强制测试案例.

机器人

[尖叫声] 在生产释放前必须进行测试. 未按规定提供发射审批测试证据的,可以撤销您对谷歌钱包生产环境的访问. 在应用前完成所有测试要求.

在将您的应用程序部署到Google Play Store之前,确保您在实施 Push Production 时注意安全,并正确测试您的代码. 为了完成这个任务 请熟悉一下 提供最佳做法。 。 。 .

关于应用Google TapAndPay SDK的应用程序部署的最新信息可见于 发射前进程 财务报告和审定财务报表 β测试 页面存档备份,存于互联网档案馆 Google 文档中。 确保完成Google在连接到 谷歌的品牌制作, (中文(简体) ), API 安全性,以及 应用程序稳定性。 。 。 .

测试要求

该应用程序需要由Google审查. 在这一过程中,它将需要通过《公约》中规定的4个强制性测试案例 官方的谷歌测试文档。它们验证您的应用程序如何在不同情况下处理卡状态跟踪.

主要测试标准包括:

• 适当处理卡状态(活动、待发、暂停等)
• 已提供卡片时纠正用户界面行为
• 敏感付款数据的安全处理
• 遵守Google品牌准则
• 适当的错误处理和用户反馈

请参看 完整的测试标准文件 在提交申请审查之前.

[注] 请务必藏起来 Add to Google Wallet 当卡片已经添加到钱包中时按钮.

iOS系统

在您的 App 中执行 In- App Push 提供功能时, 必须确保您的应用程序遵循 Apple 的功能 与苹果钱包连接的品牌指南。记住,您不能创建自己的按钮,或者您的应用程序在修订时会被拒绝 。 你可以用这个 添加Wallet按钮组件 相反! 将添加到苹果钱包按钮时显示 canAddCardToAppleWallet(primaryAccountIdentifier, lastDigits) 返回时 true,包括卡被添加到iPhone后但尚未被配对的苹果观察. 显示文本类似 Added to Apple Wallet 只有回电一次 false。通过 primaryAccountIdentifier 内 IOSCardData 因此,接下来的尝试 瞄准剩下的设备, 通过相同的 lastDigits 双方同意 这个匹配 苹果公司的应用中提供指南。 。 。 .

在品牌准则旁边,请遵循来自 提供内部文件 由苹果公司提供.

In-App提供功能在向App Store提交你的应用程序之前,必须经过苹果认证团队的审查和核实. 以下是在审查过程中可能测试的一些关键设想:

• 将一张牌输入苹果钱包
• 将一卡片输入苹果观察
• 尝试注册已经通过钱包程序添加的卡片
• 使用它的 IBAN 手动加卡
• 从同一发行方添加多张牌
• 添加和去除同一张牌
• 在提供过程中处理收到的电话
• .

苹果公司可能要求演示某些测试方案,例如验证一个单一用户加起来最多20个不同的卡的能力. 准备为此类案件提供鉴定.

此外,在向App Store提交应用程序时,必须包括:

• 测试的演示账户 .
• 演示视频展示In-App提供体验.

兼容性

@expensify/react-native-wallet 与React Introduct(0.76.0)的5个最新小版本兼容,并专门与新架构相配合.

捐款

对该图书馆的捐款按下列方式提供: https://github.com/Expensify/App (英语)请参考该回扣及其所有捐助准则.

许可证

麻省理工学院

此库由 加速和公司卡合作 软件大楼,反应土著核心贡献者和专家来建立高性能的移动解决方案.