Account Setup

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.

Foundational steps (every integration)

Create a sandbox merchant account

Create a sandbox API key

Generate your sandbox API key from the API Keys page. You’ll pass this in the Authorization header of every API request.

Invite your team

Add team members to your sandbox account so engineering, finance, and ops have the access they need.

Additional steps for Checkout integrations

If you’re integrating any Checkout products, complete these steps too:

Configure your settlement destination

From your merchant dashboard, choose where Coinflow delivers your collected revenue:

Coinflow Wallet (recommended and easiest) for all merchant types.

Want automatic settlement to your bank account? Coinflow settles to your Coinflow Wallet first, then automatically sends your balance to your bank account each day. Learn how to set it up →

Advanced: settle to wallets or contracts you control

If you operate your own treasury infrastructure, Coinflow can settle directly to destinations you control. See the advanced settlement guides for details.

Add the chargeback protection script

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.

Additional steps for Payouts from the Coinflow Wallet

If you’re paying users out from your Coinflow Wallet balance, you’ll also need to:

Configure your Coinflow Wallet

Set up your Coinflow Wallet from the Settings page.

Fund your Coinflow Wallet

Add funds to your Coinflow Wallet using the sandbox faucet. Contact support@pay.plasma.to if you need assistance.

Authorization headers

Every Coinflow API request uses these headers. Most integration guides reference them. Bookmark this section for quick lookup: Authorization Headers:

Authorization — Your API key from the merchant dashboard.
x-coinflow-auth-user-id — A unique customer ID from your own systems identifying the payer or payee.
x-coinflow-auth-session-key — A JWT that authorizes the payer. Valid for 24 hours; refresh after expiry.

What’s next

Once setup is complete, jump into the integration guide for your product: