For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
RegisterLoginSandbox Login
GuidesRecipesAPI Reference
GuidesRecipesAPI Reference
  • Product Overview
    • Products & Features
    • Key Concepts
  • Getting Started
    • Account Setup
    • Quickstart
  • Checkout
      • Getting Started with Implementation
      • Mobile App Payments
    • Settlement Locations
  • Payouts
    • Payout Overview
    • What is a Payout
  • Subscriptions
    • Subscriptions Overview
  • Marketplaces
    • Marketplace Overview
    • How Marketplaces Work
    • Marketplaces Webhooks
    • Marketplaces Implementation
  • Developer Resources
    • Custom Branding
    • Checkout Implementation
    • Webhooks
  • Merchant Dashboard
    • Login & Account Access
    • Users and Roles
    • Rate Limits
    • Developer Contact
LogoLogo
RegisterLoginSandbox Login
On this page
  • Getting Started with Coinflow Checkout Integration
  • Implementation Paths
  • Payment Methods
  • Credit Cards, Debit Cards, Apple Pay, Google Pay Payments
  • Testing 3DS
  • ACH Payments
  • Settlement Locations
  • Identifying Payers
  • Creating Session Keys
CheckoutImplementation Overview

Getting Started with Implementing Checkout

Was this page helpful?
Previous

One-Time Purchase Integration

Accept one-time card payments and settle the proceeds to your Coinflow Wallet

Next
Built with

Getting Started with Coinflow Checkout Integration

Merchants implementing checkout / pay-ins should determine which payment methods you want to support, settlement location, how you will identify the payers.

Implementation Paths

Choose the integration method that best fits your use case:

Checkout Link
React SDK
API Integration

The fastest way to get started. Generate a hosted checkout URL and redirect your users - no frontend code required.

Best for:

  • Quick integrations
  • Simple payment flows
  • Minimal development resources

View Checkout Link Guide

Payment Methods

Credit Cards, Debit Cards, Apple Pay, Google Pay Payments

Coinflow supports various payment methods, including credit cards, debit cards, Apple Pay, Google Pay, Wires, Bank Transfers. These payment methods are eligible for fraud protection coverage, including chargeback protection and 3D Secure (3DS). Coinflow recommends first testing payments without fraud protection tools enabled, then upon successful testing, test payments with chargeback protection and 3DS enabled.

For merchants enabling chargeback protection, ensure you:

  • Add the chargeback protection script to every page of your site (not just the payment page).
  • Pass chargeback protection parameters (e.g., chargebackProtectionData) to Coinflow.

Testing 3DS

To enable 3D Secure (3DS) for credit card transactions, merchants must pass the authentication3DS parameters when processing payments. If a friction challenge is required (e.g., a user must complete payment authentication), merchants must implement a 3DS challenge modal in their UI.

Note: If you’re using Coinflow’s checkout link or SDKs, no additional implementation is needed—our pre-built UI handles 3DS challenges automatically.

For testing 3DS functionality in the sandbox environment, be sure to use 3DS-enabled test card numbers.

ACH Payments

If you’re implementing ACH payments, you’ll need a bank authentication provider to allow payers to securely link their bank accounts. If you don’t have an existing bank authentication provider, you can use Coinflow’s UI for this process. Bank authentication is already included if you are implementing using Coinflow’s SDKs or Checkout link.

Payment MethodCountries Payment Method is Supported
Credit Card / Debit CardAll not on Coinflow restricted list
Apple Pay / Google PayAll not on Coinflow restricted list
ACHUnited States
SEPAEuropean Union
UK Faster PaymentsUnited Kingdom
PIXBrazil
Advanced: Stablecoin Pay-Ins

To enable stablecoin pay-ins, contact the Coinflow team. Stablecoin pay-ins are available through Coinflow’s SDKs or Checkout link only. Stablecoin pay-ins are not supported via the API.

Payment MethodCountries Supported
StablecoinAll

Settlement Locations

To begin integrating checkout with Coinflow, all merchants must first configure their settlement settings. This step is essential, as it ensures merchants can receive payments for successful transactions. Without configuring settlement settings, payment statuses will not reach the settled status, and Coinflow won’t be able to transfer funds for final settlement. Merchants must specify the settlementType when sending requests to Coinflow checkout. The correct settlement type depends on the location where the funds will be settled.

Coinflow settles funds to your bank account or to a Coinflow Wallet:

  1. Coinflow Wallet (managed, default)
  2. Your bank account
Advanced: On-Chain Settlement
  • Merchant-Managed Wallet
  • Settle to a Contract on the Configured Chain

Identifying Payers

Creating Session Keys

Most integrations identify payers by your existing customer ID. Pass any consistent string you already use in your system to create a session key.

Important: Session keys are valid for 24 hours. It’s the merchant’s responsibility to refresh the session key after it expires.

Advanced: Identifying Payers by Wallet Address

If your payers already have a wallet, you can use the wallet address to uniquely identify the payer when interacting with Coinflow. Set the x-coinflow-auth-blockchain header to the chain your payers are on.

Session Key (advanced)
1curl --request GET \
2 --url https://api-sandbox.coinflow.cash/api/auth/session-key \
3 --header 'Authorization: YOUR_API_KEY' \
4 --header 'accept: application/json' \
5 --header 'x-coinflow-auth-blockchain: <chain>' \
6 --header 'x-coinflow-auth-wallet: PAYERS_WALLET_ADDRESS'