Transfers
Move cryptocurrency between wallets
Pay-ins are used to onboard crypto into your CryptoRails space, while Transfers are used to move, bridge, or swap cryptocurrency between your customers.
To withdraw crypto to external addresses, use Payout.
Create Transfer
Transfers cryptocurrency from one customer to another. Simply provide customer IDs as identifiers—the system automatically determines which wallet and blockchain to use based on the specified rail and currency.
Automatic Wallet Detection: You don't need to know wallet addresses. Just provide customer IDs (e.g., cus_abc123) and the system handles the rest.
Common Errors
| Status | Error | Description |
|---|---|---|
400 | Insufficient balance for this transfer | Customer wallet balance is too low for the requested transfer amount |
404 | Customer not found | Source customer ID does not exist |
400 | Invalid currency | Specified currency is not supported |
404 | Wallet not found | Customer does not have a wallet for the specified rail |