Skip to navigation

Activate Passive Deposit Address

Activate a passive deposit address so it accepts new payments. If a deposit address already exists for this merchant + withdrawer + chain + token, that address is re-activated and returned. Otherwise a new session is created and its address is activated.

Authentication

x-coinflow-auth-user-idstring
OR
x-coinflow-auth-session-keystring

Request

This endpoint expects an object.
accountstringRequired

The payout account token (e.g., bank account or debit card token)

speedenumRequired
chainstringRequired

The supported chain name (e.g., "Ethereum", "Polygon", "Solana")

tokenstringRequired

The token symbol to deposit (e.g., "USDC")

returnAddressstringOptional

Optional end-user wallet address to send funds back to if a withdrawal fails, instead of returning them to the originating wallet. When it is on a different chain than the received funds (Solana USDC), the refund is routed back out through the same cross-chain provider.

idempotencyKeystringOptionalformat: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"

Response

Ok
depositAddressstring
statusenum
Allowed values: