Coinflow React Native

Withdraw Usage

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} />;

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 Usage

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} />;

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.
• supportEmail (optional): Your business support email address to use for support inquiries
• zeroAuthorization (optional): Pass in true if you wish to perform a zero authorization card transaction

Changelog

4.20.0

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

4.18.0

New CoinflowApplePayButton component

A standalone Apple Pay button that renders only the hosted Apple Pay button (not the full checkout) in a WebView.

• Accepts color (white | black) plus onApprove ({paymentId} on completion), onError, and onLoad callbacks
• Note: Apple Pay only works on a real iOS device — it will not run in the simulator

4.17.0

• New CoinflowPayPalButton component — a standalone PayPal button that renders only the hosted PayPal button (not the full checkout) in a WebView
• Accepts a PayPal email, phoneNumber, or saved token to create the order; the identifier updates live without reloading the button
• Added onApprove ({paymentId} on completion) and onError callbacks; the button is always tappable and surfaces a clear error when no identifier is provided
• Added overlayInsets ({top?, bottom?}) so the PayPal approval overlay fills only the content region (top safe area down to the tab bar) and keeps the button anchored in place while open

4.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

4.14.0

• Fixed an issue with vertical spacing when resizing the page

4.13.0

• Added userLocation property to CoinflowPurchase and CoinflowWithdraw for merchants who choose to use Geolocation checks

4.12.0

• New CoinflowCardForm, CoinflowCardNumberForm, and CoinflowCvvForm components — simple card inputs with a single tokenize() call and theme support
• Added theme options for fontSize and placeholder text

4.11.0

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

4.10.0

• Added support for CashApp redirection

4.9.2

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

4.9.1

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

4.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.

4.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.

4.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.

4.6.0

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

4.5.2

• [Bug Fix] Fixes an issue on some earlier versions of expo: Requiring unknown module "undefined".

4.5.1

• Improve the logic to handle linking users out to the browser so that it is future proofed and consistent in the future.
• Internal change to a query parameter name for zero authorization

4.5.0

• Added zeroAuthorization parameter to allow zero authorization card transactions

4.4.2

• Added email as a field for customerInfo

4.4.1

• Added redemptionCheck to purchase (Solana only)

4.4.0

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

4.3.1

• Added more chargebackProtectionData product types

4.3.0

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

4.1.6

• Support wallet connect deep links

4.1.0

• Added Multi-Currency Presentment via the presentment property

4.0.6

• Improving Withdraw With Session Keys

4.0.5

• Fixing onAuthDeclined callback

4.0.4

• Added seller prop to chargebackProtectionData

4.0.3

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

4.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

4.0.1

• Fix for iframe from here: Can't open URL about:srcdoc on IOS react-native-webview/react-native-webview#2567 (comment)
• Allow for inspection in safari from here: Feature/webview debugging enabled prop react-native-webview/react-native-webview#2937
• Fixing the use of session keys in react native SDK

4.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;
}

3.4.2

• Extended redirect blacklist for CoinflowWebView

3.4.1

• Added sessionKey authentication mechanism to CoinflowWithdraw

3.4.0

• Added sessionKey authentication mechanism to CoinflowPurchase

3.2.1

• CoinflowPurchaseV2 component added for a modernized purchase flow

3.2.0

• Added arbitrum blockchain support

3.1.5

• Allow custom taker on reservoir transactions

3.1.4

• Fix redirect bug on checkout component

3.1.0

• Added base blockchain support
• Added AuthOnly parameter to CoinflowPurchase

3.0.0

• Require signMessage on wallets for stronger withdraw authentication

2.1.13

• Added new ChargebackProtectionData productTypes

2.1.12

• Added waitForHash to EvmTransactionData

2.1.11

• Added theme props to Coinflow components for easy color control

2.1.10

• Added orderId option for reservoir items

2.1.9

• Added nativeSolToConvert for Solana transactions

2.1.7

• Settlement type param for settlement control

2.1.6

• Customer info param for added reporting capabilities

2.1.5

• Added disableGooglePay and disableApplePay props to CoinflowPurchase

2.1.2

• Bug fix for enhanced usage with Google Pay

2.1.0

• Added support for EVM NFT purchases

2.0.0

Breaking Changes

• This is enabled to true by default. If you are using a wallet that does not support versioned transactions, you must set supportsVersionedTransactions in CoinflowWithdraw to false.

1.3.1

• Added new property lockDefaultToken which locks the withdrawal option to the users default currency (USDC or EUROe)

1.3.0

• Added support for paying solana rent for a transaction

1.2.8

• Fix external linking for Coinflow URLs

1.2.7

• Fix external linking for specified URLs

1.2.6

• Added deviceId and chargebackProtectionData to CoinflowPurchase

1.2.5

• Fixing Webhook Info

1.2.3

• getFeePayer - Return the PublicKey of the Coinflow Fee Payer

Changelog

1.2.4

• Added token prop for CoinflowPurchase with polygon

1.2.3

• Fixing nSure redirect error

1.2.2

• Added Withdraw and Purchase history components

0.1.3

• Added the ability to sign transactions instead of sign messages

0.1.0

Genesis 1:1