# @coinflowlabs/react-native 中文文档

规范地址：https://npmcn.com/package/%40coinflowlabs/react-native/

版本：4\.21\.2
npm 元数据更新时间：2026-11-09T21:47:29.770Z
中文译文更新时间：2026-11-10T10:26:54.444Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40coinflowlabs/react-native
原文对照：https://npmcn.com/package/%40coinflowlabs/react-native/?lang=original
项目主页：https://github.com/coinflow-labs-us/coinflow-react-native#readme
源码仓库：https://github.com/coinflow-labs-us/coinflow-react-native

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：386 kB，136 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：bs58 \>=5\.0\.0，react \>=16，react-native \>=0\.66\.0，@solana/web3\.js ^1\.95\.4，react-native-webview \>=11\.16\.0，@coinflowlabs/lib-common \*
- 首次发布：2022-12-07T19:41:50.753Z
- 最新版本发布：2026-09-24T21:22:24.441Z
- 近 30 天下载量：113183（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：114（近 12 个月 30 个）

## 中文简介

反应本地组件用于 Coinflow

## 安装

```sh
npm install @coinflowlabs/react-native
```

也可以使用：`pnpm add @coinflowlabs/react-native`、`yarn add @coinflowlabs/react-native`、`bun add @coinflowlabs/react-native`

## README

# Coinflow 本地反应

## 撤销使用

```
import {useWallet} from '@solana/wallet-adapter-react';
const wallet = useWallet();
const connection = useConnection();

<CoinflowWithdraw wallet={wallet} merchantId='<YOUR MERCHANT ID>' env='prod|sandbox|staging' connection={connection} />;
```

道具 :

-   `wallet`: 索拉纳钱包适应器钱包
-   `merchantId`: 您的商号( 联系 Coinflow 支持此操作)
-   `connection`: 索拉连接
-   `env` (可选) : 此默认为 `prod`
    -   测试设备 `staging`
-   `onSuccess` (可选):退出进程成功时运行的功能
-   `lockAmount` (可选) : 是否让用户选择要撤回的金额或禁用输入
-   `amount` (可选) : 撤回的数额 -- -- 如 `lockAmount=true`
-   `tokens` (可选) : 定义要过滤可用符号的列表
-   `lockDefaultToken` (可选) : 只允许使用默认的符号
-   `email` (可选) : 设定要用于条目字段的默认邮件
-   `bankAccountLinkRedirect` (可选) : 用于银行账户设置的 URL
-   `additionalWallets` (可选) : 定义指定给用户的额外钱包
-   `usePermit` (可选) : 以虚假方式传递以禁用 EVM 的许可信件签名并使用批准交易
-   `transactionSigner` (可选):将实际执行提取交易的钱包的公钥 。 必须与主钱包相同的提取器相连接 .

## 购买使用

```
import {useWallet} from '@solana/wallet-adapter-react';
const wallet = useWallet();
const connection = useConnection();

<CoinflowPurchase wallet={wallet} merchantId='<YOUR MERCHANT ID>' env='prod|sandbox|staging' connection={connection} />;
```

道具 :

-   `subtotal` (可选) : 确定购买额
-   `wallet`: 索拉纳钱包适应器钱包
-   `merchantId`: 您的商号( 联系 Coinflow 支持此操作)
-   `connection`: 索拉连接
-   `env` (可选) : 此默认为 `prod`
    -   测试设备 `staging`
-   `onSuccess` (可选):在采购过程成功时运行的功能
-   `transaction` (可选性):用户运行的交易,该交易用你的智能合同来赎回他们的信用. 创建此交易, 就像您想要的, 一个普通用户, 在他们的账户中拥有 USDC .
-   `debugTx` (可选) : 设为 `true` 将用钱包签署交易,并且发送交易时不进行飞行前检查,以便更容易地调试任何问题.
-   `planCode` (可选) : 当购买订阅时,则使用订阅计划的代码.
-   `settlementType` (可选) : 购入收益使用的结算方法. (计算机、USDC或银行)
-   `webhookInfo` (可选) : 基于产品或交易的信息,在您收到有关购买的网约车时需要传输
-   `email` (可选) : 设定在电子邮件条目字段中使用的默认邮件
-   `chargebackProtectionData` (可选) :
-   `customerInfo` (可选) : 关于客户的补充资料
-   `allowedPaymentMethods` (可选) : 在UI上显示的支付方法. 如果省略,将显示所有可用的支付方法.
-   `rent` (可选,只有索拉纳): 指定块链租金金额以加总金额
-   `nativeSolToConvert` (可选,只有索拉纳): 指定用于购买的 wSOL 转换的本地 SOL 数量
-   `jwtToken` (可选):一个JWT符号,它编码了经过验证的取出参数,以防止参数被窃取.
-   `supportEmail` (可选) : 您的企业支持电子邮件地址用于支持询问
-   `zeroAuthorization` (可选) : 如果您想要执行零授权卡交易, 请通过真实文件

# 更改日志

## 4.2.0 (中文(简体) )

-   添加加载状态到 `CoinflowCardForm`, (中文(简体) ), `CoinflowCardNumberInput`, (中文(简体) ), `CoinflowCvvOnlyInput` 组件

## 4.1.8. 国家

### 新设 `CoinflowApplePayButton` 组件

#### 一个独立的Apple Pay按钮,它只让一个WebView中托管的Apple Pay按钮(而不是完整的取出).

-   接受 `color` (单位:千美元)`white` | `black`+) 加上 (中文(简体) ) `onApprove` (单位:千美元)`{paymentId}` 完成后), `onError`,以及 `onLoad` 调用
-   注意: Apple Pay 只在真实的 iOS 设备上工作——它不会在模拟器中运行

## 4.17.0 (简体中文)

-   新设 `CoinflowPayPalButton` 组件 — 一个独立 PayPal 按钮, 它只使一个 WebView 中的主机 PayPal 按钮( 而不是完整取出)
-   接受付费页 `email`, (中文(简体) ), `phoneNumber`,或已保存 `token` 创建顺序; 不重新装入按钮的标识符更新启用
-   已添加 `onApprove` (单位:千美元)`{paymentId}` (完成后)和 `onError` 回调; 未提供标识符时, 按钮总是可以抓取并显示一个明显的错误
-   已添加 `overlayInsets` (单位:千美元)`{top?, bottom?}`)所以PayPal 的核准覆盖只填充内容区域(上安全区域下至标签栏),并在打开时将按钮固定在原地

## 4.1.5. (中文)

-   已添加 `cardBackground` 改为 `MerchantTheme` 来控制内卡进入表面 独立于外表 `background`
-   已添加 `placeholderColor` 改为 `MerchantTheme` 以卡片窗体输入控制占位符文字颜色
-   固定了卡片品牌图标, 当卡片形式以狭长的宽度重流到一叠两行布局时被隐藏

## 4.14.0 (简体中文)

-   在调整页面大小时固定了垂直间隔的问题

## 4.13.0 (韩语)

-   已添加 `userLocation` 属性改为 `CoinflowPurchase` 财务报告和审定财务报表 `CoinflowWithdraw` 对选择使用地理定位检查的商人

## 4.12.0 (中文(简体) )

-   新设 `CoinflowCardForm`, (中文(简体) ), `CoinflowCardNumberForm`,以及 `CoinflowCvvForm` 组件——单一卡片输入 `tokenize()` 呼叫和主题支持
-   添加主题选项 `fontSize` 和占位符文本

## 4.11.0 (中文(简体) )

-   添加了统一保护初始化帮助和标题帮助
-   测试zipcode `00001` 触发拒绝保护欺诈

## 4.1.0 (中文(简体) )

-   添加对 CashApp 重定向的支持

## 4.9.2 国家

-   通过钱包对象时未显示会话 Key 的固定打字

## 4.9.1 国家

-   添加了支持, 以压倒( 来自商家设置的) 默认账户类型, 通过 `chargebackProtectionAccountType` 在 URL 参数中.

## 4.8.1 国家

-   通过下列方式增加自定义付费支持: `customPayInFees` 在 JWT 符号或 URL 参数中。 这使得商人们可以添加在取出时显示的自定义收费行项目(固定或按百分比计价).

## 4.8.0 (单位:千美元)

-   New Blockchain Support:SDK现在支持Stellar,一个快速而低成本的支付区块链. 通过块链='stellar'以启用斯特拉尔支付处理.

## 4.7.0 (单位:千美元)

-   在 CoinflowPurchase 中添加了零授权Config道具,用于控制零授权行为(显示/隐藏保存的支付方法,以令牌验证特定的卡). 折旧是ZeroAuthorization布尔道具.

## 4.6.0 (简体中文)

-   新块链支持:SDK现在支持Monad,一种高性能的EVM相容块链. 通过块链='monad' 以启用 Monad 支付处理.

## 4.5.2 国家

-   \[Bug Fix\] 在一些早期版本的博览会上解决了一个问题: `Requiring unknown module "undefined".`

## 4.5.1 国家

-   改进处理用户与浏览器的连接的逻辑,使之在未来得到验证和一致.
-   内部更改为零授权的查询参数名称

## 4.5.0 (中文(简体) )

-   添加零授权参数以允许零授权卡交易

## 4.4.2 国家

-   添加邮件作为客户端的字段Info

## 4.4.1 国家

-   已添加 `redemptionCheck` (仅索拉纳)

## 4.4.0 (单位:千美元)

-   已添加 `allowedWithdrawSpeeds` 查询参数允许商家指定何种退出速度。 默认是全部.

## 4.3.1 国家

-   添加更多内容 `chargebackProtectionData` 产品类型

## 4.3.0 (单位:千美元)

-   已添加 `partialUsdcChecked` 要预选的 USDC 部分付款复选框

## 4.1.6 (中文(简体) )

-   支持钱包连接深层链接

## 4.1.0 (中文(简体) )

-   通过 `presentment` 属性

## 4.0.6 (单位:千美元)

-   用会话键改进撤回

## 4.0.5 (单位:千美元)

-   修复 `onAuthDeclined` 回调

## 4.0.4 (中文(简体) )

-   已添加 `seller` 向 `chargebackProtectionData`

## 4.0.3 国家

-   将 3DS 挑战处理添加到独立的 Google 付费按钮

## 4.0.2 (中文(简体) )

-   已添加 `allowedPaymentMethods` 改为 `CoinflowPurchase`
-   选项是:
    -   “卡”=信用卡和借记卡
    -   'ach' = ACH 银行账户转账
    -   “快速付款” = 联合王国快速付款(英镑银行转账)
    -   “sepa” = SEPA 银行账户转账(欧元银行转账)
    -   “ pix” = Pix 银行账户转账( BRL 银行转账)
    -   “usdc” = USDC
    -   "googlePay"=谷歌付费
    -   "苹果Pay"=苹果付费
    -   “信贷”=信贷

## 4.0.1 (中文(简体) )

-   从这里修复 Iframe: 不能打开关于:srcdoc on IOS reaction-native-webview/ react-native-webview# 2567 (评论) 的 URL
-   允许在此进行搜索: 功能/ 网络视图调试启用道具反应- native- webview/ react- native-webview# 2937
-   调整会话键在本地 SDK 反应中的使用

## 4.0.0 (单位:千美元)

-   折旧 `amount` 财务报告和审定财务报表 `token` 以下列方式获取的小计:
-   为列报添加多货币支持
-   SEPA 和联合王国快速支付支助

```js
{
  cents: number;
  currency: 'USD' | 'EUR' | 'GBP' | 'BRL';
}
```

或者说

```js
{
  address: string;
  amount: number;
}
```

## 3.4.2 国家

-   Coinflow WebView 扩展方向黑名单

## 3.4.1 国家

-   添加会话关键认证机制到 `CoinflowWithdraw`

## 3.4.0 (中文(简体) )

-   添加会话关键认证机制到 `CoinflowPurchase`

## 3.2.1 国家

-   为现代化采购流程添加了合并流量PurchaseV2组件

## 3.2.0 (中文(简体) )

-   添加的仲裁块链支持

## 3.1.5 国家

-   允许自定义接收库交易

## 3.1.4 国家

-   在退出组件中修正方向错误

## 3.1.0 (中文(简体) )

-   添加了基础块链支持
-   添加 Auth 参数到 CoinflowPurchase

## 3.0.0 (单位:千美元)

-   需求 `signMessage` 在钱包上进行更强的提取认证

## 2.1.13 信息技术

-   添加了新的充值保护数据产品类型

## 2.1.12

-   已添加 `waitForHash` 到 Evm 交易数据

## 2.1.11

-   已添加 `theme` 方便色彩控制的 Coinflow 组件道具

## 2.1.10 联合国

-   已添加 `orderId` 库项选项

## 2.1.9

-   已添加 `nativeSolToConvert` 索拉纳交易

## 2.1.7

-   住区类型 住区控制参数

## 2.1.6

-   增加报告能力的客户信息参数

## 2.1.5

-   添加已禁用 GooglePay 和已禁用 ApplePay 道具到 CoinflowPurcase

## 2.1.2

-   用 Google Pay 改进用途的臭虫修复

## 2.1.0 国家

-   增加了对EVM NFT采购的支持

### 2.0.0 (韩语)

**中断更改**

-   默认启用此选项可实现 。 如果您正在使用不支持已版本交易的钱包, 您必须设定 `supportsVersionedTransactions` 内 `CoinflowWithdraw` 改为 `false`。 。 。 .

### 1.3.1 国家

-   添加了新属性锁 DefaultToken 将退出选项锁定在用户默认货币(USDC 或 EUROe)中

### 1.3.0 (单位:千美元)

-   额外支持支付一笔交易的索拉纳租金

# 1.2.8 国家

-   修复 Coinflow URL 的外部链接

# 1.2.7 国家

-   为指定的 URL 修复外部链接

# 1.2.6 联合国

-   添加设备ID和充电保护数据到 CoinflowPurchase

# 1.2.5 国家

-   正在修复 Webhook 信息

# 1.2.3 联合国

-   `getFeePayer` - 归还 `PublicKey` 汇入费支付人

# 更改日志

### 1.2.4 国家

-   已添加 `token` 用于 `CoinflowPurchase` 有多边形

### 1.2.3 联合国

-   正在修复确定方向错误

### 1.2.2 国家

-   添加了撤回和采购历史组件

### 1.1.3 国家

-   添加了签名交易而不是签名信件的能力

# 0.1.0 (中文(简体) )

创世纪1:1

## 常见问题

### @coinflowlabs/react-native 是什么？

反应本地组件用于 Coinflow

### 如何安装 @coinflowlabs/react-native？

在项目目录运行 npm install @coinflowlabs/react-native，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=16）、react-native（\>=0\.66\.0）、react-native-webview（\>=11\.16\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @coinflowlabs/react-native 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @coinflowlabs/react-native 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @coinflowlabs/react-native 可以商用吗？

@coinflowlabs/react-native 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @coinflowlabs/react-native 的下载量有多少？

根据 npm 官方下载统计，@coinflowlabs/react-native 在 2026/10/11 – 2026/11/09 这 30 天内被下载 113,183 次，日均约 3,773 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @coinflowlabs/react-native 还在维护吗？

最新版本 4\.21\.2 发布于 2026/09/25（1 个月前）；至今共发布 114 个版本，其中过去 12 个月发布了 30 个；首次发布于 2022/12/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。