Transfers

Transfers are the core functionality of the Swipelux Crypto Rails. They allow you to seamlessly convert into, out of, and between all forms of a dollar for your customers.

Simple from / to API

Our transfer API uses an intuitive rail-first approach with a simple from and to structure. This unified interface handles all transfer types: onramp, bridge, swap, and mixed scenarios:

{
  "from": {
    "identifier": "cus_123",       // Customer ID
    "amount": "50",                // Amount to transfer
    "rail": "card",                // Payment rail - see Rails guide
    "currency": "USD"              // Fiat currency for onramp rails, or crypto currency (e.g. "USDC") for network rails
  },
  "to": {
    "identifier": "cus_123",       // Destination (customer wallet or external address)
    "currency": "USDC"             // Crypto currency for destination
  }
}

Transfer Types:

• Bridge: Same currency across different networks (e.g., USDC Ethereum → USDC Polygon)
• Swap: Different currencies on same rail (e.g., USD → EUR via wire)
• Mixed: Combined currency conversion + network change (e.g., EUR card → USDC Polygon)
• Onramp: Fiat to crypto conversion (e.g., USD card → USDC)
• Offramp: Crypto to fiat conversion (e.g., USDC → USD card)

💡 Learn more: Visit our comprehensive Rails guide to see detailed examples of bridges, swaps, mixed transfers, and all supported rails.

Interactive Transfer Builder

Explore how different combinations of rails and currencies create different transfer types. Modify the values in the JSON to see how the request body changes and automatic transfer type detection works.

Native Onramp Experience

Our onramp rails provide built-in fiat-to-crypto conversion with superior wallet compatibility. While we support various onramp providers, our native solution offers the best integration experience.

Transfer Restrictions

• Onramp transfers (fiat → crypto): Must go to the customer's own wallet
• Crypto transfers (crypto → crypto): Must go from customer's wallet to an external address
• Wallet requirement: Customers must have at least one wallet before creating transfers

Supported fiat currencies

At the moment, we only support USD as a fiat currency. We'll quickly expand to support other fiat currencies in the future.

Supported crypto currencies

At the moment, we only support USDC as a crypto currency. We'll quickly expand to support other crypto currencies in the future.

Guides