❓FAQs
Checkouts
Are there minimum/maximum purchase amounts?
The minimum purchase amount is $0.50, and the maximum can be configured based on your risk tolerance.
- Card Limits: 10,000 per card.
- ACH Limits: $50,000
If you require higher card limits than what’s listed above, reach out to our sales team.
How does the charge appear on an end-user's credit card statement?
Merchants with their own MID will have their own statement descriptor as you will be the merchant of record.
Can a card be charged but the end-user never signs the transaction?
Yes, in this case, the user will see that they have a balance which can be redeemed and sent to you. If they request a refund, you or Coinflow can refund the card and decrease their balance via the admin panel.
Does Coinflow support disabling certain payment methods?
Yes! Just let someone on the Coinflow team know and we’ll update your merchant settings on our end.
Can I authorize a payment upfront and capture it at a later time?
Yes, our platform supports authorizing a payment upfront, allowing you to capture it at a later time once the seller accepts the offer. By default, merchants have a 7-day window to capture the payment before it’s automatically voided. This provides flexibility to confirm transactions only after both parties are ready. When calling our checkout endpoints, set authOnly = true to authorize the payment. Then, call the capture endpoint when you’re ready.
Can purchases be made with non-stable tokens?
Yes! Please see this doc to learn how to accept payments in other tokens.
What could cause a 51 response for cards?
- Maxed-Out Credit Limit – cardholder has already used up their available credit, so the tx would push them over their limit.
- Pending Transactions Holding Funds – Even if the statement balance looks okay, pending transactions might be tying up available credit.
- Credit Card Issuer’s Risk Controls – Some banks enforce soft spending limits based on user behavior or payment history, even if the full credit limit hasn’t been reached.
- Declined Due to Overlimit Restrictions – Some issuers allow transactions to exceed the credit limit, while others decline them outright with a 51.
- Payment Not Processed Yet – If the cardholder recently paid off their balance, but the bank hasn’t cleared it yet, their available credit might still be low.
Refunds
How long does it take for a refund to settle?
Typically 2-3 days, although it depends on the bank.
Subscriptions
Do you support subscriptions / auto-recurring payments?
Yes, all major payment providers support subscription payments.
Chargebacks and Fraud Detection
How are chargebacks handled?
If a chargeback occurs, we will be notified by our payment processor. We will initiate the refund if possible, and if not, we will initiate the process with the card network. If the chargeback is lost, we will request the USDC from the original purchase amount to be sent back to us.
Do you have any automated fraud detection measures in place?
Yes, our systems perform automatic fraud detection on all cards, making sure they match with records on file and are within constraints for device risk scores.
Withdraws
How can a Withdrawer change their currency?
USD withdrawals are only available to users who verified with a U.S. ID, due to address requirements for USD payouts.
BRL withdrawals are only available to users who verified with a Brazilian ID, as PIX requires a Brazilian Tax ID.
EUR ↔ GBP conversions are allowed at any time for users in Europe and the UK, as long as the destination bank account matches the chosen currency.
What are the average response times for KYC/KYB?
KYC - Average response time is under 10 seconds
KYB - Average response time is about 30 seconds for automatic verification. If the end-user fails, that attempt is a manual review which can take up to 24 hours. Our team gets notified of failures and can approve. Most companies (90%) pass within that first 30 seconds.
My customer hasn't received their withdrawal.
Merchants should take the following steps to check the status of a withdrawal:
- If the status of the withdrawal is not completed, tell the customer the funds will arrive by the estimated arrival date.
- If the status is completed, have the customer check if they see a payment amount (minus fees) from any of the following statement descriptors:
- Coinflow
- Aptpay
- Coin FX
- Cybrid
- Dwolla
- Merge
Blockchains
Which blockchains does Coinflow support?
Coinflow can currently support transactions on Solana, Ethereum, Base, Polygon, Arbitrum, Near. If you would like to inquire if we can support a chain you’re on, please reach out to the Coinflow team.
What blockchain does Coinflow recommend to use?
Coinflow recommends customers leverage the power of Solana for extremely cheap and fast transactions. In fact, Solana is so cheap that Coinflow covers all fees paid for processing transactions - a cost effective advantage compared to leveraging alternative blockchains.
What is the transaction object?
A transaction object is like a digital receipt for an online bank transfer. It shows who sent money, who received it, how much was sent, and any specific instructions or notes about the transaction. This “receipt” is then recorded on the blockchain, a public ledger that everyone can see.
What operations happen on-chain and off-chain?
Everything happens off-chain except for the movement of the USDC.
Do you support custom wallets? How does it work?
Yes. Coinflow accepts any wallet! You will need to create an object which is passed into the “wallet” prop of the react component. That object needs to adhere to the following interfaces:
Solana:
EVM:
How can I check my token balance?
Copy the account address and enter it into a blockchain explorer like etherscan.io. From here, you can access all token holdings.
How can I refill testnet liquidity?
To refill Testnet liquidity, send tokens directly to these contract addresses:
ETH Sepolia:
Base Sepolia:
Polygon Amoy:
For ETH you will need to supply wETH/wMATIC which you can get by calling the deposit function of the token’s contract and depositing ETH/MATIC.
Webhooks
What webhook events can I receive?
What are the data limitations that can be passed into the webhookInfo object?
You can pass any valid JSON object into the webhookInfo object. It is recommended to pass any webhook info that you want to receive here.
When exactly does the Webhook fire?
The Webhook fires on completion of the on-chain transaction.
What happens if the chain transaction is slow, or Solana has an outage, chain errors, retries, etc.?
The credit cards will process, and the on-chain transactions are delayed in our queue and re-tried until the chain comes back online. Nothing is ever dropped from our systems. We have been developing applications on Solana since 2021 and have learned how to maintain system operations / recovery in the case of an outage.
Plaid
What login credentials can I use to connect bank accounts through Plaid on sandbox?
Use the Plaid’s sandbox credentials as noted here through each step of Checkout or Withdraw.
Fees
What fees will the end user see during checkout?
During checkout, end users will typically see two types of fees: transaction fees and service fees. Transaction fees cover the blockchain processing costs for the transaction, while service fees represent Coinflow’s charges, as outlined in the MSA.
What are the default sandbox fee settings, and can I customize them?
Fees on sandbox are defaulted to use pays fees when you create an account. Merchants that have a signed MSA can request to have their sandbox settings to match that of their MSA on sandbox, if it hasn’t been updated already. You may also request to have your settings configured so that merchant pays fees. Merchant pays fees means that you, the merchant, will cover the costs, and Coinflow will invoice you at the end of the month.
Why do the fees for a payment seem different than the amount I calculated?
Card fees are calculated using the NSure variable fees and card variable fees based on the total amount. The formula used for calculating the total amount (T) is as follows:
- Total Amount (T)
- NSure Variable Fee (NV)
- NSure Fixed Fee (NF)
- Card Variable Fee (CV)
- Card Fixed Fee (CF)
- Subtotal (S)
The formula is:
To solve for the total amount (T), rearrange the formula:
Example Calculation:
- Subtotal (S) = $100
- NSure Variable Fee (NV) = 0.01
- NSure Fixed Fee (NF) = $0.37
- Card Variable Fee (CV) = 0.05
- Card Fixed Fee (CF) = $0.35
Using the formula:
The total transaction amount rounded up would be (T) = $107.15.
If the customer is paying both for the product/service and the fees(the default setting), then the transaction fees are included in the total amount charged to the customer. If the merchant is paying the fees, the total charged to the customer would be the same as the subtotal, with the fees deducted from the merchant before settlement. If you’d like Coinflow to configure your account so that merchant pays fees, please reach out to the team.

