Account Setup
Prerequisites every Coinflow integration depends on — sandbox merchant account, API keys, team access, settlement configuration, and (for Checkout) chargeback protection.
Prerequisites every Coinflow integration depends on — sandbox merchant account, API keys, team access, settlement configuration, and (for Checkout) chargeback protection.
This page lists the foundational prerequisites that apply to every Coinflow integration. Complete these steps once before integrating any product. Each individual integration guide assumes these are done.
Register a new sandbox merchant account or log in to an existing one.
Generate your sandbox API key from the
API Keys page. You’ll
pass this in the Authorization header of every API request.
Add team members to your sandbox account so engineering, finance, and ops have the access they need.
If you’re integrating any Checkout product (card, ACH, crypto, Apple Pay, Google Pay, etc.), complete these steps too:
From the Settings page, pick where Coinflow should send your revenue:
Add the chargeback protection script to every page of your app. This is required for fraud detection and is a prerequisite for collecting payer events.
If you’re paying users from your in-app Coinflow wallet (rather than from a BYO wallet), you’ll also need to:
Add USDC to your in-app wallet using the sandbox faucet. Reach out to the Coinflow team for the public key if needed.
Every Coinflow API request uses these headers. Most integration guides reference them — bookmark this section for quick lookup:
Once setup is complete, jump into the integration guide for your product: