Crypto

Rail overview

Use CRYPTO when funds move through a wallet address rather than a bank rail.

Conomy treats the wallet transfer as a rail node and tracks provider or chain confirmation before advancing the payment lifecycle.

Region Global

Currency Crypto asset

Direction Pay-in / Pay-out

Model Wallet transfer

Always bind network, asset, and wallet address together in your UI; wrong-network sends are operationally expensive.

Required fields

type (string): Must be "CRYPTO".
currency (string): Settlement currency for the flow.
wallet.address (string): Source or destination wallet address.

Optional fields

wallet.provider (string): Provider identifier.
wallet.referenceId (string): External wallet identifier.
wallet.token (string): Token symbol.
wallet.network (string): Chain/network (for example ETH, TRON, SOLANA).

Example

{
  "type": "CRYPTO",
  "currency": "USDC",
  "wallet": {
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "network": "ETH",
    "token": "USDC"
  }
}

Valid combinations

CRYPTO -> ACCOUNT
ACCOUNT -> CRYPTO

Object

Optional provider identifier.

Optional external wallet id in the provider system.

Optional token symbol (e.g., USDC, USDT).

Optional blockchain network (e.g., ETH, TRON, SOLANA).

Wallet address used to receive or send funds.