# @coinflowlabs/react 中文文档

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

版本：6\.0\.0
npm 元数据更新时间：2026-10-31T20:08:24.077Z
中文译文更新时间：2026-10-31T20:31:09.529Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：821 kB，316 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：bs58 ~5\.0\.0，react \>=16，@solana/web3\.js \>=1\.54\.0，@coinflowlabs/lib-common \*
- 首次发布：2022-11-16T22:02:05.046Z
- 最新版本发布：2026-10-31T20:08:23.918Z
- 已发布版本数：125（近 12 个月 26 个）

## 中文简介

回流回收的React组件

## 安装

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

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

## 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' connection={connection} />;
```

道具:

-   `wallet`：索拉纳钱包适配器钱包
-   `merchantId`您的商家ID（请联系Coinflow支持）
-   `connection`：索拉纳连接
-   `env` （可选）：默认为 `prod`
    -   对于测试设置为 `sandbox`
-   `onSuccess` （可选）：取款过程成功时运行的函数
-   `lockAmount` （可选）：是否允许用户选择提现金额或禁用输入
-   `amount` （可选）：提款金额-如有需要 `lockAmount=true`
-   `tokens` （可选）：定义一个列表来过滤可用的令牌
-   `lockDefaultToken` （可选）：只允许使用默认令牌
-   `email` （可选）：设置输入字段中使用的默认电子邮件
-   `bankAccountLinkRedirect` （可选）：用于银行账户设置的URL
-   `additionalWallets` （可选）：定义分配给用户的额外钱包
-   `usePermit` （可选）：传递为false禁用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`您的商家ID（请联系Coinflow支持）
-   `connection`：索拉纳连接
-   `env` （可选）：默认为 `prod`
    -   对于测试设置为 `staging`
-   `onSuccess` （可选）：购买过程成功时运行的函数
-   `transaction` （可选）：用户运行的交易，用你的智能合约兑换他们的信用。创建此事务，就像为帐户中有USDC的普通用户创建事务一样。
-   `debugTx` （可选）：设置为 `true` 将与钱包签署交易，并在没有预先检查的情况下发送交易，以便更容易地调试任何问题。
-   `planCode` （可选）：购买订阅时，订阅计划的代码。
-   `settlementType` （可选）：用于购买收益的结算方法。（信贷，USDC或银行）
-   `webhookInfo` （可选）：当您收到有关购买的webhook时，您希望传输的基于产品或交易的信息
-   `email` （可选）：设置在电子邮件输入字段中使用的默认电子邮件
-   `chargebackProtectionData` (可选):
-   `customerInfo` （可选）：客户的附加信息
-   `allowedPaymentMethods` （可选）：界面显示的支付方式。如果省略，将显示所有可用的付款方式。
-   `rent` （可选，仅限Solana）：指定要添加到总数中的区块链租金金额
-   `nativeSolToConvert` （可选，仅限Solana）：指定要为购买转换wSOL的本机SOL数量
-   `jwtToken` （可选）：一个JWT令牌，它对验证的签出参数进行编码，以防止欺骗参数。
-   `supportEmail` （可选）：您的业务支持电子邮件地址，用于支持查询
-   `zeroAuthorization` （可选）：如果希望执行零授权卡交易，则传入true

## 跑龙套

`CoinflowUtils`

-   `getFeePayer` -返回 `PublicKey` 汇入费支付人的名单

# 更新日志

## 0

-   **打破:** 删除了已弃用的旧卡表单组件： `CoinflowCardNumberInput`， `CoinflowCvvInput`， `CoinflowCvvOnlyInput`， `CoinflowCardOnlyInput`， `CoinflowCardFormHeader` 和他们的 `CoinflowLegacy*` 别名。使用 `CoinflowCardForm`， `CoinflowCardNumberForm` 或者 `CoinflowCvvForm` 代替。

## 5.21.0

-   的加载状态 `CoinflowCardForm`， `CoinflowCardNumberInput`， `CoinflowCvvOnlyInput` 组件

## 5.19.0

-   `CoinflowVenmoButton` 现在将Venmo的审批流程呈现为页面内模式，而不是弹出窗口
-   **打破**： `CoinflowVenmoButton` 现在需要一个 `overlayId` Prop -批准覆盖在打开时填充的元素的id，匹配 `CoinflowPayPalButton`

## 5.17.0

-   添加 `CoinflowVenmoButton` 让商家在自己的结账界面中嵌入Venmo按钮

## 5.16.0

-   添加 `CoinflowPayPalButton` 让商家在自己的结账界面中嵌入PayPal按钮

## 5.15.0

-   添加 `cardBackground` 来 `MerchantTheme` 独立于外部画布控制内部卡片输入表面 `background`
-   添加 `placeholderColor` 来 `MerchantTheme` 控制卡片表单输入中的占位符文本颜色
-   固定的卡片品牌图标被隐藏时，卡片形式回流到一个堆叠的两行布局在狭窄的宽度

## 5.14.0

-   修正了调整页面大小时垂直间距的问题

## 5.11.0

-   增加了统一的保护初始化助手和headers助手
-   测试zipcode `00001` 触发欺诈保护拒绝

## 5.10.0

-   增加了对CashApp重定向的支持

## 5.9.2

-   修正了在传递钱包对象时sessionKey不存在的问题

## 5.9.1

-   增加了对覆盖默认帐户类型（从商家设置）用于退款保护的支持 `chargebackProtectionAccountType` URL参数中。

## 5.8.1

-   增加了对自定义付费费用的支持 `customPayInFees` 在JWT令牌或URL参数中。这允许商家添加自定义费用项目（固定的或基于百分比的），并在结账时显示。

## 5.8.0

-   新的区块链支持：SDK现在支持恒星，一个快速和低成本的区块链支付。通过区块链='stellar'来启用stellar支付处理。

## 5.7.0

-   在CoinflowPurchase中添加了zeroAuthorizationConfig道具，用于控制零授权行为（显示/隐藏保存的支付方法，通过令牌验证特定的卡）。弃用isZeroAuthorization布尔属性。

## 5.6.0

-   新的区块链支持：SDK现在支持Monad，这是一种高性能的evm兼容区块链。通过区块链='monad'来启用monad支付处理。

## 5.5.1

-   对零授权的查询参数名称进行内部更改

## 发送的

-   增加了zeroAuthorization参数，允许零授权卡事务

## 5.4.4

-   NSure SDK作为依赖项添加

## 5.4.3

-   添加email作为customerInfo字段

## 5.4.2

-   加载Checkout表单时，性能有了很大的改进

## 5.4.1之前

-   添加 `redemptionCheck` 购买（仅限索拉纳）

## 5.4.0

-   添加 `allowedWithdrawSpeeds` 查询参数，允许商家指定允许的提现速度。默认值是all。

## 5.3.1

-   增加了更多的 `chargebackProtectionData` 产品类型

## 5.3.0

-   添加 `partialUsdcChecked` 属性以预先检查部分USDC付款复选框

## 5.1.0

-   增加了多币种显示 `presentment` 财产

## 5.0.9

-   改进会话键退出

## 5.0.8

-   在渲染前同步添加无凭据

## 5.0.7

-   向iframe添加无凭据

## 5.0.6

-   修复 `onAuthDeclined` 回调

## 5.0.5

-   添加 `seller` 支撑 `chargebackProtectionData`

## 5.0.4

-   添加3DS挑战处理独立谷歌支付按钮

## 5.0.3

-   添加 `allowedPaymentMethods` 来 `CoinflowPurchase`
-   选项有:
    -   ‘card’ =信用卡和借记卡
    -   ‘ach’ = ach银行账户转账
    -   “更快的支付”=英国更快的支付（英镑银行转账）
    -   ‘sepa’ = sepa银行账户转账（欧元银行转账）
    -   ‘pix’ = pix银行账户转账（巴西货币银行转账）
    -   ‘usdc’ = usdc
    -   ‘googlePay’ =谷歌Pay
    -   ‘applePay’ = Apple Pay
    -   ‘credits’ =积分

## 正式

## 正式

-   允许复制到剪贴板为流Iframe

## 5.0.1

-   添加 `onAuthDeclined` 回调 `CoinflowPurchase`

## 5.0.0

-   不以为然的 `amount` 和 `token` 支持小计，可通过以下方式获取：
-   增加了多币种显示支持
-   SEPA和英国快速支付支持

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

或者

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

## 4.5.2

-   更新可选的对等依赖，以便与各种捆绑器配合良好

## 4.5.1

-   增加了sessionKey认证机制 `CoinflowWithdraw`

## 4.5.0

-   增加了sessionKey认证机制 `CoinflowPurchase`

## 4.1.1

-   添加 `onError` 回调Apple Pay和谷歌支付按钮

## 4.4.0

-   增加覆盖到数字钱包按钮，使加载时间为0

## 4.3.1

-   为现代化的购买流添加了CoinflowPurchaseV2组件

## 4.3.0

-   增加了仲裁区块链支持

## 4.2.10

-   添加 `getWalletFromEmail` 函数 `CoinflowUtils`

## 4.2.9

-   为卡片表单元素添加了占位符CSS

## 4.2.8

-   卡片元素的自定义字体

## 4.2.5

-   允许自定义接管水库交易

## 4.2.4

-   记住信用卡输入的样式

## 4.1.0

-   添加基础区块链支持
-   CoinflowPurchase增加AuthOnly参数

## 4.0.0

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

## 3.1.11

-   增加了新的ChargebackProtectionData产品类型

## 3.1.10

-   添加 `waitForHash` 对EvmTransactionData

## 3.1.9

-   添加 `theme` 道具到Coinflow组件，便于颜色控制

## 3.1.8中

-   添加 `orderId` 存储库项目的选项

## 3.1.7

-   添加 `nativeSolToConvert` 索拉纳交易

## 3.1.5

-   沉降控制的沉降类型参数

## 3.1.4

-   用于添加报告功能的客户信息参数

## 3.1.2

-   添加了disableGooglePay和disableApplePay道具到CoinflowPurchase

## 3.1.1

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

## 3.0.1

-   更新 `CoinflowPurchaseProtection` 让 `partnerId` 要求

### 3.0.0

**打破变化**

-   为CoinflowWithdraw添加了supportsVersionedTransactions，允许支持版本化交易的钱包平台在单笔交易中以更好的价格提取非usdc /欧元代币。
-   默认情况下，该选项为true。如果您使用的钱包不支持版本化交易，则必须设置 `supportsVersionedTransactions` 在 `CoinflowWithdraw` 来 `false`.

### 2.7.1

-   添加了新的属性lockDefaultToken，它将提现选项锁定到用户的默认货币（美元或欧元）

### 2.7.0

-   增加了为交易支付索拉纳租金的支持
-   增加相机支持文档验证

### 2.6.1

-   增加了对SSR的内置支持，修复了“窗口未定义”错误。

### 2.6.0

-   增加了对Apple Pay和谷歌Pay的支持

### 2.5.0

-   添加了 `CoinflowCardForm` 组件，该组件允许商家以PCI兼容的方式从用户收集信用卡信息。标记它，然后利用Coinflow的api的剩余部分。

### 测试盒框

-   增加了对以太坊主网的支持

### 2.3.2

-   增加了输入 `ChargebackProtectionData`
-   添加 `token` 支持 `CoinflowPurchase` 与多边形

### tripwire

支持CoinflowPurchase中的版本化交易

### 2.2.0

添加了useSocket属性来处理iframe消息不可用的浏览器实例

### 2.1.1

-   修复了在使用handleHeightChange道具时设置useHeightChange url参数为true的Bug

### 魅惑

-   添加handleHeightChange到所有组件，允许动态高度变化

### 2.0.0

-   删除大多数大型第三方库的硬需求
-   改进了钱包和交易的类型检查

### 1.3.0

-   增加了对多边形区块链的支持
-   增加了对非usdc令牌Solana Checkout的支持

### 1.2.0

-   增加了对以太坊主网区块链的支持

### 1.0.0

-   增加了对NEAR区块链的支持

### 0.3.0

-   增加了撤回和购买历史记录组件

### 0.2.11

-   修正了魔术钱包和版本化交易的错误

### 0.2.9

-   增加了签名事务的功能

### 0.2.6虽然只是0.2.7

-   添加 `CoinflowUtils.getFeePayer()` 以取得Coinflow付款人的PublicKey

### 0.2.5

-   修复了当传递partialSigners不与setup事务一起工作时的问题

### 0.2.4

-   设置和赎回交易现在运行无gas，这不需要用户在他们的帐户中有SOL来与coinflow交互

### 0.2.2, 0.2.3

-   添加了可选的debugTx参数，以便更容易地调试任何与赎回事务相关的问题。

### 0.2.1

-   添加可选的partialSigners参数到CoinflowPurchase组件，这样可以支持需要部分签名者的赎回txs。

### 0.2.0

-   在CoinflowPurchase组件中添加了事务可选参数，允许在购买时自动兑换积分。

## 常见问题

### @coinflowlabs/react 是什么？

回流回收的React组件

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

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

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

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

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

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

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

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

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

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