CheckoutPayment MethodsPayment MethodsCrypto Payments

🪙 Token Payments

Learn how to accept payments in any token and receive USDC as settlement.

Overview

For crypto pay-ins, Coinflow supports allowing customers to make payments on multiple blockchain networks and tokens, and settle in USDC to the Merchant. Customers can connect their wallets, view available tokens, and send payments to a designated address.

How It Works

  1. The payer chooses to pay with cryptocurrency and selects their preferred funding source.
  2. If the payer has an existing wallet, they can make a wallet connection then view all available tokens across different blockchains to pay with. This allows them to choose both the token and the network for their transaction.
  3. If the payer has an Coinbase account, they can connect their Coinbase account, then complete their payment with ETH or USD.
  4. If the payer wants to pay from anywhere, The payer selects a cryptocurrency and chain for the transaction. The system then provides a unique address for them to send their payment. The payer will need to the selected cryptocurrency to the provided address, completing the transaction.

Supported Chains and Tokens

See this link for a list of supported chains and tokens for crypto payins.

Overview of How Crypto Pay-Ins Work

Flow of Funds

Demos


Payer selects payment by Crypto and selects source of funds for crypto payment
Payer selects payment by Crypto and selects source of funds for crypto payment.
Payer with connected wallet sees all tokens on all chains and can select which token + chain to pay with

Payer with connected wallet.
(Payer sees all tokens on all chains and can select which token + chain to pay with).

Payer who is paying from anywhere to an address. (User selects the chain, which token, and is given an address to send the crypto to).

Payer who is paying from anywhere to an address.
(User selects the chain, which token, and is given an address to send the crypto to).

👍 Contact the Coinflow team to enable crypto payins on your account.

Please share your merchant id on sandbox and/or production.

Overview of Crypto Refunds

For crypto refunds, Coinflow supports allowing customers to refund on multiple blockchain networks and tokens, and settle in USDC to the customers wallet. Customers can connect their wallets, and receive refunds their wallet addresses.

How It Works

  1. The payer chooses to pay with cryptocurrency and selects their preferred funding source.
  2. If the payer has an existing wallet, they can make a wallet connection then view all available tokens across different blockchains to pay with. This allows them to choose both the token and the network for their transaction.
  3. The payer can then transfer their cryptocurrency to a wallet or transfer to an external wallet address
  4. In the event of underpayment or failure, the transaction will fail and the user will be presented with a modal that provides a session ID and a return wallet address. This is where the user can provide the address to return the funds.

Merchant Webhook Notifications

When a customer sends the wrong amount of crypto, Coinflow automatically notifies your server via webhook so you can take action or surface the refund link directly in your own UI.

EventWhen it firesPayment outcome
Crypto OverpaymentCustomer sent more than requiredPayment settles successfully; excess is refundable
Crypto UnderpaymentCustomer sent less than requiredPayment fails; full amount is refundable

Both events share the same payload shape:

1{
2  "eventType": "Crypto Overpayment",
3  "category": "Purchase",
4  "created": "2025-03-15T14:23:01.000Z",
5  "data": {
6    "paymentId": "78f9be3f-691f-4f8c-82f7-c70221b006e7",
7    "sessionId": "ses_abc123xyz",
8    "refundUrl": "https://deposit.paywithglide.xyz/coinflow.cash.prod?mode=refund&glideSessionId=ses_abc123xyz&refundToken=tok_abc123",
9    "expectedAmount": "10.00",
10    "actualAmount": "12.50",
11    "currencySymbol": "USDC",
12    "actualAmountUSD": "12.50"
13  }
14}

The refundUrl in the webhook payload is a direct link to the Glide refund portal for that session. You can pass this URL to your customer so they can submit their wallet address and receive their funds back. Coinflow also automatically sends the customer an email with this link.

The paymentId, sessionId, and amount values shown above are examples only and are not reflective of real production values.

To subscribe to these events, go to Coinflow Admin Dashboard → Developers → Webhooks, select the latest webhook version, and enable Crypto Overpayment and/or Crypto Underpayment. See Configuring Webhooks for setup instructions.

Demos

Payer will confirm purchase of x value


Payer will then choose a wallet or transfer to another temporary wallet.

Payer will then choose a transfer chain and select their currency.

Select your wallet on Phantom/Metamask (I’m purposefully going to input an amount less than 10.05 USDC we’re expecting).

Once you send the amount (under expectation) you will receive a transaction failed modal. Here there will be a session ID you can refer to (our your developers) and an input field where you can enter your return address.

Crypto Payment Statuses

StatusDescription
settledThe payment was successfully completed. Coinflow received the crypto payment, processed it, and sent USDC to the merchant account. At this point, the merchant has been paid.