Create transfers for customer | Swipelux Documentation

Create Transfer

Purpose: Create crypto-to-crypto transfers to move cryptocurrency between wallets.

Transfers allow you to send cryptocurrency from a customer's wallet to an external wallet address. The transfer endpoint handles on-chain crypto transactions on the same network (e.g., polygon→polygon).

For Fiat Deposits: To add fiat funds to a wallet (card, bank transfer, Apple Pay), use the PayIn endpoint instead. It provides onramp payment links for fiat-to-crypto conversions.

Backward Compatibility: This endpoint still supports fiat rails (card, wire, apple_pay, etc.) for backward compatibility with existing integrations. However, for new integrations, we recommend using the PayIn endpoint for fiat onramps.

Dynamic Request Structure

The transfer API uses a flexible JSON structure that adapts based on your specific needs:

from - Source of funds (customer + rail/currency/amount)
to - Destination (customer identifier or wallet address)
rail - Payment method (card, bank_transfer, wallet, etc.)
currency - Fiat currency (USD, EUR) or crypto asset (USDC, ETH)

The request body dynamically adjusts based on the combination of rails and assets you choose. Explore the tabs below for detailed information about payment rails and supported assets.

Interactive Transfer Builder

Transfer Request

{

"from": {

"identifier":

"cus_123" ▼

"amount":"100",

"rail":

"card" ▼

"currency":

"USD" ▼

"to": {

"identifier":

"cus_123" ▼

"rail":

"polygon" ▼

"currency":

"USDC" ▼

}

Onramp Transfer100 USD

Convert USD from card to USDC on polygon

Response Example

{
  "id": "tr_nEZHWur1pBSAKY7NlV",
  "from": {
    "identifier": "cus_cK69MttD5nAUAbud1B",
    "amount": "50",
    "rail": "card",
    "currency": "USD"
  },
  "to": {
    "identifier": "cus_cK69MttD5nAUAbud1B"
  },
  "state": "awaiting_funds",
  "url": "https://pay.swipelux.com/checkout/..."
}