❓FAQs

Frequently Asked Questions about Coinflow.

Checkouts

The minimum purchase amount is $0.50, and the maximum can be configured based on your risk tolerance.

  • Card Limits: 5,000pertransaction.Themaxlimitis5,000 per transaction. The max limit is 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.

Merchants with their own MID will have their own statement descriptor as you will be the merchant of record.

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.

Yes! Just let someone on the Coinflow team know and we’ll update your merchant settings on our end.

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.

Yes! Please see this doc to learn how to accept payments in other tokens.

  1. Maxed-Out Credit Limit – cardholder has already used up their available credit, so the tx would push them over their limit.
  2. Pending Transactions Holding Funds – Even if the statement balance looks okay, pending transactions might be tying up available credit.
  3. 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.
  4. Declined Due to Overlimit Restrictions – Some issuers allow transactions to exceed the credit limit, while others decline them outright with a 51.
  5. 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

Typically 2-3 days, although it depends on the bank.


Subscriptions

Yes, all major payment providers support subscription payments.


Chargebacks and Fraud Detection

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.

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

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.

Change currency documentation

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.

Merchants should take the following steps to check the status of a withdrawal:

  1. If the status of the withdrawal is not completed, tell the customer the funds will arrive by the estimated arrival date.
  2. 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

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.

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.

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.

Everything happens off-chain except for the movement of the USDC.

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:

1{
2 publicKey: PublicKey,
3 signMessage: (message: UInt8Array) => Promise<UInt8Array>,
4 sendTransaction: (transaction: Transaction | VersionedTransaction) => Promise<string>
5}

EVM:

1{
2 address: string;
3 sendTransaction: (transaction) => Promise<{hash: string}>;
4 signMessage: (message: string) => Promise<string>;
5}

Copy the account address and enter it into a blockchain explorer like etherscan.io. From here, you can access all token holdings.

To refill Testnet liquidity, send tokens directly to these contract addresses:

ETH Sepolia:

1{
2 swapRouter: 0x95987F8e0AD35409fcd55faB4404E3Dd8E834F62,
3 wETH: 0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14
4}

Base Sepolia:

1{
2 swapRouter: 0x9327d0cc6584AbfbB07BD82aEE9C837d41051672,
3 wETH: 0x4200000000000000000000000000000000000006
4}

Polygon Amoy:

1{
2 swapRouter: 0x582Cc62af26FC4A1D5054b18a86087416bB025fb,
3 wMATIC: 0x0ae690AAD8663aaB12a671A6A0d74242332de85f
4}

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

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.

The Webhook fires on completion of the on-chain transaction.

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

Use the Plaid’s sandbox credentials as noted here through each step of Checkout or Withdraw.


Fees

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.

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.

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:

T = NV * T + CV * T + S + NF + CF

To solve for the total amount (T), rearrange the formula:

T = - (S + CF + NF) / (CV + NV - 1)

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:

T = - ($100 + $0.35 + $0.37) / (0.05 + 0.01 - 1)
T = - $100.72 / -0.94
T = 107.148936

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.