@coinflowlabs/react

中文文档
6.0.0发布于 2026/11/01Apache-2.0TypeScriptESM + CJS

回流回收的React组件

中文使用文档
文档目录88 节
  1. 撤回使用
  2. 购买使用
  3. 跑龙套
  4. 0
  5. 5.21.0
  6. 5.19.0
  7. 5.17.0
  8. 5.16.0
  9. 5.15.0
  10. 5.14.0
  11. 5.11.0
  12. 5.10.0
  13. 5.9.2
  14. 5.9.1
  15. 5.8.1
  16. 5.8.0
  17. 5.7.0
  18. 5.6.0
  19. 5.5.1
  20. 发送的
  21. 5.4.4
  22. 5.4.3
  23. 5.4.2
  24. 5.4.1之前
  25. 5.4.0
  26. 5.3.1
  27. 5.3.0
  28. 5.1.0
  29. 5.0.9
  30. 5.0.8
  31. 5.0.7
  32. 5.0.6
  33. 5.0.5
  34. 5.0.4
  35. 5.0.3
  36. 正式
  37. 正式
  38. 5.0.1
  39. 5.0.0
  40. 4.5.2
  41. 4.5.1
  42. 4.5.0
  43. 4.1.1
  44. 4.4.0
  45. 4.3.1
  46. 4.3.0
  47. 4.2.10
  48. 4.2.9
  49. 4.2.8
  50. 4.2.5
  51. 4.2.4
  52. 4.1.0
  53. 4.0.0
  54. 3.1.11
  55. 3.1.10
  56. 3.1.9
  57. 3.1.8中
  58. 3.1.7
  59. 3.1.5
  60. 3.1.4
  61. 3.1.2
  62. 3.1.1
  63. 3.0.1
  64. 3.0.0
  65. 2.7.1
  66. 2.7.0
  67. 2.6.1
  68. 2.6.0
  69. 2.5.0
  70. 测试盒框
  71. 2.3.2
  72. tripwire
  73. 2.2.0
  74. 2.1.1
  75. 魅惑
  76. 2.0.0
  77. 1.3.0
  78. 1.2.0
  79. 1.0.0
  80. 0.3.0
  81. 0.2.11
  82. 0.2.9
  83. 0.2.6虽然只是0.2.7
  84. 0.2.5
  85. 0.2.4
  86. 0.2.2, 0.2.3
  87. 0.2.1
  88. 0.2.0

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和英国快速支付支持
{
  cents: number;
  currency: 'USD' | 'EUR' | 'GBP' | 'BRL';
}

或者

{
  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 共发布 125 个版本,首次发布于 2022/11/17;过去 12 个月发布了 26 个版本。

版本发布日期距今
6.0.0latest2026/11/012 天前
5.22.32026/10/0628 天前
5.22.22026/09/251 个月前
5.22.12026/09/231 个月前
5.22.02026/08/202 个月前
5.21.12026/08/082 个月前

关于 @coinflowlabs/react 的常见问题

@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 和提交记录判断。