# @coinflowlabs/vue 中文文档 规范地址：https://npmcn.com/package/%40coinflowlabs/vue/ 版本：2\.0\.0 npm 元数据更新时间：2026-10-31T20:08:53.529Z 中文译文更新时间：2026-10-31T20:25:31.748Z 软件包许可：未声明 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40coinflowlabs/vue 原文对照：https://npmcn.com/package/%40coinflowlabs/vue/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.6 MB，55 个文件 - 模块格式：ESM + CJS - TypeScript 类型：未声明 - 运行依赖：2 个 - peer 依赖：vue ^3\.4\.30，bs58 ^4\.0\.1，@solana/web3\.js \>=1\.54\.0 - 首次发布：2024-06-28T20:00:47.240Z - 最新版本发布：2026-10-31T20:08:53.368Z - 已发布版本数：55（近 12 个月 23 个） ## 中文简介 - 新 `CoinflowCardForm` 支持变体的组件(`card-form`， `card-number-form`， `cvv-form`) -简单的卡输入与单一 `tokenize()` 呼叫和完整的主题支持-主题选项： `font`， `fontSize`， `background`， `textColor`”showCardIcon ## 安装 ```sh npm install @coinflowlabs/vue ``` 也可以使用：`pnpm add @coinflowlabs/vue`、`yarn add @coinflowlabs/vue`、`bun add @coinflowlabs/vue` ## README # Coinflow Vue ## 更新日志 ### 1.12.0 - 新 `CoinflowCardForm` 支持变体的组件(`card-form`， `card-number-form`， `cvv-form`) -简单的卡输入与单一 `tokenize()` 呼叫和完整的主题支持 - 主题选择: `font`， `fontSize`， `background`， `textColor`， `showCardIcon`， `cardNumberPlaceholder`， `cvvPlaceholder`， `expirationPlaceholder` - `showCardIcon`：在卡号输入的同时，显示检测到的信用卡品牌（Visa、Mastercard等） - 改进了浏览器对卡片字段的自动完成支持 - 改进了iframe通信的安全性 ## 撤回 道具: - `wallet`：索拉纳钱包适配器钱包 - `merchantId`您的商家ID（请联系Coinflow支持） - `connection`：索拉纳连接 - `env` （可选）：默认为 `prod` - 对于测试设置为 `staging` - `onSuccess` （可选）：取款过程成功时运行的函数 - `lockAmount` （可选）：是否允许用户选择提现金额或禁用输入 - `amount` （可选）：提款金额-如有需要 `lockAmount=true` - `tokens` （可选）：定义一个列表来过滤可用的令牌 - `lockDefaultToken` （可选）：只允许使用默认令牌 - `email` （可选）：设置输入字段中使用的默认电子邮件 - `bankAccountLinkRedirect` （可选）：用于银行账户设置的URL - `additionalWallets` （可选）：定义分配给用户的额外钱包 - `usePermit` （可选）：传递为false禁用EVM的允许消息签名，并使用批准事务 - `transactionSigner` （可选）：实际执行提现交易的钱包公钥。必须与主钱包关联到同一个提款人。 ## 购买 道具: - `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令牌，它对验证的签出参数进行编码，以防止欺骗参数。 - `zeroAuthorization` （可选）：如果希望执行零授权卡交易，则传入true # 更新日志 ## 2.0.0 - **打破:** 删除了已弃用的旧卡表单组件： `CoinflowCardNumberInput`， `CoinflowCvvInput`， `CoinflowCvvOnlyInput`， `CoinflowCardNumberOnlyInput` 和他们的 `CoinflowLegacy*` 别名。使用 `CoinflowCardForm` 代替。 ## 1.18.0 - 的加载状态 `CoinflowCardForm`， `CoinflowCardNumberInput`， `CoinflowCvvOnlyInput` 组件 ## 1.15.0 - 添加 `cardBackground` 来 `MerchantTheme` 独立于外部画布控制内部卡片输入表面 `background` - 添加 `placeholderColor` 来 `MerchantTheme` 控制卡片表单输入中的占位符文本颜色 - 固定的卡片品牌图标被隐藏时，卡片形式回流到一个堆叠的两行布局在狭窄的宽度 ## 1.14.0 - 修正了调整页面大小时垂直间距的问题 ## 1.11.0 - 增加了统一的保护初始化助手和headers助手 - 测试zipcode `00001` 触发欺诈保护拒绝 ## 1.10.0 - 增加了对CashApp重定向的支持 ## 1.9.2 - 修正了在传递钱包对象时sessionKey不存在的问题 ## 1.9.1 - 增加了对覆盖默认帐户类型（从商家设置）用于退款保护的支持 `chargebackProtectionAccountType` URL参数中。 ## 1.8.1 - 增加了对自定义付费费用的支持 `customPayInFees` 在JWT令牌或URL参数中。这允许商家添加自定义费用项目（固定的或基于百分比的），并在结账时显示。 ## 1.8.0 - 新的区块链支持：SDK现在支持恒星，一个快速和低成本的区块链支付。通过区块链='stellar'来启用stellar支付处理。 ## 1.7.0 - 在CoinflowPurchase中添加了zeroAuthorizationConfig道具，用于控制零授权行为（显示/隐藏保存的支付方法，通过令牌验证特定的卡）。弃用isZeroAuthorization布尔属性。 ## 1.6.0 - 新的区块链支持：SDK现在支持Monad，这是一种高性能的evm兼容区块链。通过区块链='monad'来启用monad支付处理。 ## 1.5.1 - 对零授权的查询参数名称进行内部更改 ## 1.5.0 - 增加了zeroAuthorization参数，允许零授权卡事务 ## 3 - NSure SDK作为依赖项添加 ## 1.4.2 - 添加email作为customerInfo字段 ## 1.4.1 - 添加 `redemptionCheck` 购买（仅限索拉纳） ## 1.4.0 - 添加 `allowedWithdrawSpeeds` 查询参数，允许商家指定允许的提现速度。默认值是all。 ## 1.3.1 - 增加了更多的 `chargebackProtectionData` 产品类型 ## 1.3.0 - 添加 `partialUsdcChecked` 属性以预先检查部分USDC付款复选框 ## 1.1.0 - 增加了多币种显示 `presentment` 财产 ## 1.0.7 - 改进会话键退出 ## 1.0.6 - 向iframe添加无凭据 ## 1.0.5 - 修复 `onAuthDeclined` 回调 ## 1.0.4 - 添加 `seller` 支撑 `chargebackProtectionData` ## 1.0.3 - 添加3DS挑战处理独立谷歌支付按钮 ## 1.0.2中 - 添加 `allowedPaymentMethods` 来 `CoinflowPurchase` - 选项有: - ‘card’ =信用卡和借记卡 - ‘ach’ = ach银行账户转账 - “更快的支付”=英国更快的支付（英镑银行转账） - ‘sepa’ = sepa银行账户转账（欧元银行转账） - ‘pix’ = pix银行账户转账（巴西货币银行转账） - ‘usdc’ = usdc - ‘googlePay’ =谷歌Pay - ‘applePay’ = Apple Pay - ‘credits’ =积分 ## 1.0.1 - 允许复制到剪贴板为流Iframe ## 1.0.0 - 不以为然的 `amount` 和 `token` 支持小计，可通过以下方式获取： - 增加了多币种显示支持 - SEPA和英国快速支付支持 ```js { cents: number; currency: 'USD' | 'EUR' | 'GBP' | 'BRL'; } ``` 或者 ```js { address: string; amount: number; } ``` ## 0.3.1 - 增加了sessionKey认证机制 `CoinflowWithdraw` ## 0.3.1 - 允许更高版本的Vue作为对等依赖 ## 0.3.0 - 增加了sessionKey认证机制 `CoinflowPurchase` ## 0.2.8 - 添加 `onError` 回调Apple Pay和谷歌支付按钮 ## 0.2.7 - 增加覆盖到数字钱包按钮，使加载时间为0 ## 0.2.6虽然只是 - 固定 `CoinflowCvvOnlyInput` 问题 ## 0.2.5 - 添加 `getWalletFromEmail` 函数 `CoinflowUtils` ## 0.2.4 - 为卡片表单元素添加了占位符CSS ## 0.2.3 - 卡片元素的自定义字体 ## 1.0.0 - SDK的初始版本 ## 常见问题 ### @coinflowlabs/vue 是什么？ 新 CoinflowCardForm 支持变体的组件\(card-form， card-number-form， cvv-form\) -简单的卡输入与单一 tokenize\(\) 呼叫和完整的主题支持-主题选项： font， fontSize， background， textColor”showCardIcon ### 如何安装 @coinflowlabs/vue？ 在项目目录运行 npm install @coinflowlabs/vue，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.4\.30）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @coinflowlabs/vue 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/coinflowlabs\_\_vue 是否存在。 ### @coinflowlabs/vue 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @coinflowlabs/vue 可以商用吗？ @coinflowlabs/vue 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @coinflowlabs/vue 还在维护吗？ 最新版本 2\.0\.0 发布于 2026/11/01（2 天前）；至今共发布 55 个版本，其中过去 12 个月发布了 23 个；首次发布于 2024/06/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。