@coinflowlabs/vue

中文文档
2.0.0发布于 2026/11/01ESM + CJS
  • New CoinflowCardForm component with variant support (card-form, card-number-form, cvv-form) — simple card inputs with a single tokenize() call and full theme support - Theme options: font, fontSize, background, textColor, `showCardIcon
原始使用文档
文档目录43 节
  1. Changelog
  2. 1.12.0
  3. Withdraw
  4. Purchase
  5. 2.0.0
  6. 1.18.0
  7. 1.15.0
  8. 1.14.0
  9. 1.11.0
  10. 1.10.0
  11. 1.9.2
  12. 1.9.1
  13. 1.8.1
  14. 1.8.0
  15. 1.7.0
  16. 1.6.0
  17. 1.5.1
  18. 1.5.0
  19. 1.4.3
  20. 1.4.2
  21. 1.4.1
  22. 1.4.0
  23. 1.3.1
  24. 1.3.0
  25. 1.1.0
  26. 1.0.7
  27. 1.0.6
  28. 1.0.5
  29. 1.0.4
  30. 1.0.3
  31. 1.0.2
  32. 1.0.1
  33. 1.0.0
  34. 0.3.1
  35. 0.3.1
  36. 0.3.0
  37. 0.2.8
  38. 0.2.7
  39. 0.2.6
  40. 0.2.5
  41. 0.2.4
  42. 0.2.3
  43. 1.0.0

Coinflow Vue

Changelog

1.12.0

  • New CoinflowCardForm component with variant support (card-form, card-number-form, cvv-form) — simple card inputs with a single tokenize() call and full theme support
  • Theme options: font, fontSize, background, textColor, showCardIcon, cardNumberPlaceholder, cvvPlaceholder, expirationPlaceholder
  • showCardIcon: display the detected card brand (Visa, Mastercard, etc.) inline with the card number input
  • Improved browser autocomplete support for card fields
  • Improved security for iframe communication

Withdraw

Props:

  • wallet: The Solana Wallet Adapter Wallet
  • merchantId: Your Merchant ID (Contact Coinflow support for this)
  • connection: Solana Connection
  • env (optional): This defaults to prod
    • For testing set to staging
  • onSuccess (optional): function to run when the withdrawal process is successful
  • lockAmount (optional): Whether to let the user select the amount to withdraw or to disable the input
  • amount (optional): The amount to withdraw - required if lockAmount=true
  • tokens (optional): Define a list to filter the available tokens
  • lockDefaultToken (optional): Only allow the default token to be used
  • email (optional): Set the default email to be used in entry fields
  • bankAccountLinkRedirect (optional): The URL to be used for bank account setup
  • additionalWallets (optional): Define additional wallets to assign to the user
  • usePermit (optional): Pass as false to disable permit message signing for EVM and use approve transactions
  • transactionSigner (optional): Public Key of the wallet which will actually execute the withdrawal transaction. Must be associated with the same withdrawer as the main wallet.

Purchase

Props:

  • subtotal (optional): Fix the amount of purchase
  • wallet: The Solana Wallet Adapter Wallet
  • merchantId: Your Merchant ID (Contact Coinflow support for this)
  • connection: Solana Connection
  • env (optional): This defaults to prod
    • For testing set to staging
  • onSuccess (optional): function to run when the purchase process is successful
  • transaction (optional): transaction for the user to run which redeems their credits with your smart contract. Create this transaction just like you would for a normal user who has USDC in their account.
  • debugTx (optional): Setting this to true will sign the transaction with the wallet, and send the transaction with no preflight checks allowing for easier debug of any issues.
  • planCode (optional): When a subscription is being purchased, the code of the subscription plan.
  • settlementType (optional): The settlement method to use for the proceeds of a purchase. (Credits, USDC, or Bank)
  • webhookInfo (optional): Product or transaction based information that you want transmitted when you receive webhooks regarding the purchase
  • email (optional): Set the default email to use in email entry fields
  • chargebackProtectionData (optional):
  • customerInfo (optional): Additional information about the customer
  • allowedPaymentMethods (optional): The payment methods displayed on the UI. If omitted, all available payment methods will be displayed.
  • rent (optional, Solana only): Specify the blockchain rent amount to add to the total
  • nativeSolToConvert (optional, Solana only): Specify the amount of native SOL to convert wSOL for the purchase
  • jwtToken (optional): A JWT token which encodes verified checkout parameters to prevent spoofing of arguments.
  • zeroAuthorization (optional): Pass in true if you wish to perform a zero authorization card transaction

Changelog

2.0.0

  • Breaking: Removed the deprecated legacy card form components: CoinflowCardNumberInput, CoinflowCvvInput, CoinflowCvvOnlyInput, CoinflowCardNumberOnlyInput and their CoinflowLegacy* aliases. Use CoinflowCardForm instead.

1.18.0

  • Added loading states to the CoinflowCardForm, CoinflowCardNumberInput, CoinflowCvvOnlyInput components

1.15.0

  • Added cardBackground to MerchantTheme to control the inner card-entry surface independently of the outer canvas background
  • Added placeholderColor to MerchantTheme to control placeholder text color in card form inputs
  • Fixed the card brand icon being hidden when the card form reflows to a stacked two-row layout at narrow widths

1.14.0

  • Fixed an issue with vertical spacing when resizing the page

1.11.0

  • Added unified protection initialization helper and headers helper
  • Test zipcode 00001 triggers fraud protection rejection

1.10.0

  • Added support for CashApp redirection

1.9.2

  • Fixed typing for sessionKey being not present when passing the wallet object

1.9.1

  • Added support for overriding the default account type (from merchant settings) used for chargeback protection via chargebackProtectionAccountType in the URL parameters.

1.8.1

  • Added support for custom pay-in fees via customPayInFees in the JWT token or URL parameters. This allows merchants to add custom fee line items (fixed or percentage-based) that are displayed during checkout.

1.8.0

  • New Blockchain Support: The SDK now supports Stellar, a fast and low-cost blockchain for payments. Pass blockchain='stellar' to enable Stellar payment processing.

1.7.0

  • Added zeroAuthorizationConfig prop to CoinflowPurchase for controlling zero authorization behavior (show/hide saved payment methods, verify a specific card by token). Deprecates isZeroAuthorization boolean prop.

1.6.0

  • New Blockchain Support: The SDK now supports Monad, a high-performance EVM-compatible blockchain. Pass blockchain='monad' to enable Monad payment processing.

1.5.1

  • Internal change to a query parameter name for zero authorization

1.5.0

  • Added zeroAuthorization parameter to allow zero authorization card transactions

1.4.3

  • NSure SDK added as a dependency

1.4.2

  • Added email as a field for customerInfo

1.4.1

  • Added redemptionCheck to purchase (Solana only)

1.4.0

  • Added allowedWithdrawSpeeds query parameter to allow merchants to specify what withdraw speeds are allowed. The default is all.

1.3.1

  • Added more chargebackProtectionData product types

1.3.0

  • Added partialUsdcChecked property to pre-check partial USDC payment checkbox

1.1.0

  • Added Multi-Currency Presentment via the presentment property

1.0.7

  • Improving Withdraw With Session Keys

1.0.6

  • Add credentialless to iframe

1.0.5

  • Fixing onAuthDeclined callback

1.0.4

  • Added seller prop to chargebackProtectionData

1.0.3

  • Added 3DS Challenge Handling to the standalone Google Pay button

1.0.2

  • Added allowedPaymentMethods to CoinflowPurchase
  • Options are:
    • 'card' = Credit and debit cards
    • 'ach' = ACH bank account transfers
    • 'fasterPayments' = UK Faster Payments (GBP Bank Transfers)
    • 'sepa' = SEPA bank account transfers (EUR Bank Transfers)
    • 'pix' = Pix bank account transfers (BRL Bank Transfers)
    • 'usdc' = USDC
    • 'googlePay' = Google Pay
    • 'applePay' = Apple Pay
    • 'credits' = Credits

1.0.1

  • Allow copy to clipboard for Coinflow Iframe

1.0.0

  • Deprecating amount and token in favor of subtotal which can be accessed via the following ways:
  • Added multi-currency support for presentment
  • SEPA and UK Faster Payments support
{
  cents: number;
  currency: 'USD' | 'EUR' | 'GBP' | 'BRL';
}

or

{
  address: string;
  amount: number;
}

0.3.1

  • Added sessionKey authentication mechanism to CoinflowWithdraw

0.3.1

  • Allow higher versions of Vue as a peer dependency

0.3.0

  • Added sessionKey authentication mechanism to CoinflowPurchase

0.2.8

  • Added onError callback to Apple Pay and Google Pay buttons

0.2.7

  • Added overlay to digital wallet buttons to make the loading time 0

0.2.6

  • Fixed CoinflowCvvOnlyInput issues

0.2.5

  • Added getWalletFromEmail function to CoinflowUtils

0.2.4

  • Added placeholder CSS to card form elements

0.2.3

  • Custom fonts for card elements

1.0.0

  • Initial Version of the SDK

版本与发布记录

@coinflowlabs/vue 共发布 55 个版本,首次发布于 2024/06/29;过去 12 个月发布了 23 个版本。

版本发布日期距今
2.0.0latest2026/11/012 天前
1.19.22026/10/0628 天前
1.19.12026/09/251 个月前
1.19.02026/08/202 个月前
1.18.12026/08/082 个月前
1.18.02026/07/213 个月前

关于 @coinflowlabs/vue 的常见问题

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