SWIFT Payouts

Overview

Accept cryptocurrency deposits and send fiat payments via SWIFT wire transfer to any bank account globally.

How It Works

Create transfer - Specify crypto source and SWIFT destination
Get deposit instructions - Receive wallet address and amount
Send crypto - Customer deposits to the provided address
Receive fiat - Funds arrive via SWIFT wire transfer

Prerequisites

Verified customer (KYB/KYC completed)
External bank account configured for SWIFT
Supported stablecoins: USDC, USDT, PYUSD

Bank Account Setup

import requests

response = requests.post(
    'https://api.infinite.dev/v1/external-bank-accounts',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'customerId': 'cus_abc123',
        'beneficiaryName': 'Acme Corporation Ltd',
        'beneficiaryType': 'business',
        'paymentRails': ['swift'],
        'beneficiaryAddress': {
            'addressLine1': '123 Business Ave',
            'city': 'New York',
            'state': 'NY',
            'postalCode': '10001',
            'country': 'US',
        },
        'bankName': 'JPMorgan Chase Bank',
        'bankAddress': {
            'addressLine1': '456 Wall Street',
            'city': 'New York',
            'state': 'NY',
            'postalCode': '10005',
            'country': 'US',
        },
        'swiftBic': 'CHASUS33XXX',
        'accountNumber': '1234567890',
    },
)

const response = await fetch('https://api.infinite.dev/v1/external-bank-accounts', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    customerId: 'cus_abc123',
    beneficiaryName: 'Acme Corporation Ltd',
    beneficiaryType: 'business',
    paymentRails: ['swift'],
    beneficiaryAddress: {
      addressLine1: '123 Business Ave',
      city: 'New York',
      state: 'NY',
      postalCode: '10001',
      country: 'US',
    },
    bankName: 'JPMorgan Chase Bank',
    bankAddress: {
      addressLine1: '456 Wall Street',
      city: 'New York',
      state: 'NY',
      postalCode: '10005',
      country: 'US',
    },
    swiftBic: 'CHASUS33XXX',
    accountNumber: '1234567890',
  }),
});

export INFINITE_API_KEY=YOUR_API_KEY
infinite api POST /v1/external-bank-accounts --body '{
  "customerId": "cus_abc123",
  "beneficiaryName": "Acme Corporation Ltd",
  "beneficiaryType": "business",
  "paymentRails": ["swift"],
  "beneficiaryAddress": {
    "addressLine1": "123 Business Ave",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "bankName": "JPMorgan Chase Bank",
  "bankAddress": {
    "addressLine1": "456 Wall Street",
    "city": "New York",
    "state": "NY",
    "postalCode": "10005",
    "country": "US"
  },
  "swiftBic": "CHASUS33XXX",
  "accountNumber": "1234567890"
}'

Add a SWIFT bank account for cus_abc123: Acme Corporation Ltd (business), JPMorgan Chase Bank, BIC CHASUS33XXX, account 1234567890, beneficiary address 123 Business Ave, New York, NY 10001, US; bank address 456 Wall Street, New York, NY 10005, US.

# Infinite MCP is read-only today — run the CLI tab to execute.

curl -X POST "https://api.infinite.dev/v1/external-bank-accounts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cus_abc123",
    "beneficiaryName": "Acme Corporation Ltd",
    "beneficiaryType": "business",
    "paymentRails": ["swift"],
    "beneficiaryAddress": {
      "addressLine1": "123 Business Ave",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "US"
    },
    "bankName": "JPMorgan Chase Bank",
    "bankAddress": {
      "addressLine1": "456 Wall Street",
      "city": "New York",
      "state": "NY",
      "postalCode": "10005",
      "country": "US"
    },
    "swiftBic": "CHASUS33XXX",
    "accountNumber": "1234567890"
  }'

Creating a SWIFT Transfer

To initiate a crypto-to-SWIFT transfer, you can specify the source in multiple ways:

import requests

response = requests.post(
    'https://api.infinite.dev/v1/transfers',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'onBehalfOf': 'cus_abc123',
        'amount': {
            'currency': 'usdc',
            'rawValue': '100000000',
        },
        'source': {
            'currency': 'usdc',
            'paymentRail': 'ETHEREUM',
            'accountId': 'ewa_abc123',
        },
        'destination': {
            'currency': 'usd',
            'paymentRail': 'SWIFT',
            'accountId': 'eba_bank_123',
            'swiftReference': 'Invoice #2026-001',
        },
        'paymentReason': 'PAYMENT_FOR_GOODS_AND_SERVICES',
    },
)

const response = await fetch('https://api.infinite.dev/v1/transfers', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    onBehalfOf: 'cus_abc123',
    amount: {
      currency: 'usdc',
      rawValue: '100000000',
    },
    source: {
      currency: 'usdc',
      paymentRail: 'ETHEREUM',
      accountId: 'ewa_abc123',
    },
    destination: {
      currency: 'usd',
      paymentRail: 'SWIFT',
      accountId: 'eba_bank_123',
      swiftReference: 'Invoice #2026-001',
    },
    paymentReason: 'PAYMENT_FOR_GOODS_AND_SERVICES',
  }),
});

export INFINITE_API_KEY=YOUR_API_KEY
infinite api POST /v1/transfers --body '{
  "onBehalfOf": "cus_abc123",
  "amount": {
    "currency": "usdc",
    "rawValue": "100000000"
  },
  "source": {
    "currency": "usdc",
    "paymentRail": "ETHEREUM",
    "accountId": "ewa_abc123"
  },
  "destination": {
    "currency": "usd",
    "paymentRail": "SWIFT",
    "accountId": "eba_bank_123",
    "swiftReference": "Invoice #2026-001"
  },
  "paymentReason": "PAYMENT_FOR_GOODS_AND_SERVICES"
}'

Send 100 USDC from ewa_abc123 on Ethereum to eba_bank_123 as USD by SWIFT on behalf of cus_abc123, for goods and services, with reference "Invoice #2026-001".

# With an agent key the assistant calls create_transfer (draft) then submit_transfer; with an org key run the CLI tab.

curl -X POST "https://api.infinite.dev/v1/transfers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "onBehalfOf": "cus_abc123",
    "amount": {
      "currency": "usdc",
      "rawValue": "100000000"
    },
    "source": {
      "currency": "usdc",
      "paymentRail": "ETHEREUM",
      "accountId": "ewa_abc123"
    },
    "destination": {
      "currency": "usd",
      "paymentRail": "SWIFT",
      "accountId": "eba_bank_123",
      "swiftReference": "Invoice #2026-001"
    },
    "paymentReason": "PAYMENT_FOR_GOODS_AND_SERVICES"
  }'

Response

{
  "id": "tfr_abc123",
  "status": "PENDING",
  "sourceAmount": {
    "currency": "USDC",
    "exponent": 6,
    "value": "100000000",
    "displayValue": "100.00"
  },
  "destinationAmount": null,
  "depositInstructions": {
    "type": "crypto",
    "paymentRail": "ETHEREUM",
    "toAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "amount": {
      "currency": "USDC",
      "exponent": 6,
      "value": "100000000",
      "displayValue": "100.00"
    }
  }
}

The destinationAmount is calculated after the crypto deposit is confirmed, based on current exchange rates and applicable fees.

Deposit Instructions

The transfer response includes deposit instructions with:

toAddress - Destination wallet address
amount - Amount as a MoneyOutput object (see Currency Amount Format)
paymentRail - Blockchain network

Transfer States

SWIFT transfers progress through several states:

Status	Substatus	Description
`PENDING`	`AWAITING_CRYPTO_DEPOSIT`	Waiting for the customer to send crypto. This ends once the deposit is confirmed.
`PENDING`	`SWIFT_PENDING_APPROVAL`	Crypto received, awaiting operations approval
`PROCESSING`	`SWIFT_APPROVED`	Approved, ready for SWIFT processing
`COMPLETED`	-	SWIFT transfer sent successfully
`FAILED`	-	Transfer failed (with reason in metadata)

Once the crypto deposit is confirmed, status is no longer PENDING. A compliance or missing-document hold is IN_REVIEW. Otherwise the transfer is PROCESSING. A confirmed deposit is not still waiting for funds.

Monitoring Transfer Status

Poll the transfer status to track progress:

import requests

response = requests.get(
    'https://api.infinite.dev/v1/transfers/tfr_abc123',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
    },
)

const response = await fetch('https://api.infinite.dev/v1/transfers/tfr_abc123', {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});

export INFINITE_API_KEY=YOUR_API_KEY
infinite transfers get tfr_abc123

Show me transfer tfr_abc123.

curl -X GET "https://api.infinite.dev/v1/transfers/tfr_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Check the transfer status endpoint to monitor progress. When completed, the response includes the final destination amount, bank reference, and SWIFT tracking UETR.

Webhooks

Configure webhooks to receive real-time updates:

{
  "id": "evt_abc123",
  "timestamp": "2026-01-15T10:30:00Z",
  "apiVersion": "1.0",
  "organizationId": "org_abc123",
  "type": "transfer.completed",
  "data": {
    "id": "tfr_abc123",
    "status": "COMPLETED",
    "sourceAmount": {
      "currency": "USDC",
      "exponent": 6,
      "value": "100000000",
      "displayValue": "100.00"
    },
    "destinationAmount": {
      "currency": "USD",
      "exponent": 2,
      "value": "9950",
      "displayValue": "99.50"
    }
  }
}

Processing Timeline

Crypto confirmation: 12+ confirmations on Ethereum (~3 minutes)
Processing time: 1-2 business hours during business days
SWIFT delivery: 1-3 business days depending on destination

Common Errors

Failed transfers include a failureReason in the metadata:

Insufficient deposit - Amount received doesn’t match expected
Invalid beneficiary - Incorrect SWIFT/IBAN details
Compliance rejection - Transfer blocked by compliance checks

Sandbox Testing

Use test wallet addresses from deposit instructions
Test with simulated crypto deposits
Validate using sandbox bank details

Features

Real-time tracking with SWIFT UETR
Same-day processing available

Support

For any assistance, reach out to us via Slack or contact:

General support: support@infinite.dev
Compliance inquiries: compliance@infinite.dev

Get started

Core Concepts

Guides

Overview

How It Works

Prerequisites

Bank Account Setup

Creating a SWIFT Transfer

Response

Deposit Instructions

Transfer States

Monitoring Transfer Status

Webhooks

Processing Timeline

Common Errors

Sandbox Testing

Features

Support

​Overview

​How It Works

​Prerequisites

​Bank Account Setup

​Creating a SWIFT Transfer

​Response

​Deposit Instructions

​Transfer States

​Monitoring Transfer Status

​Webhooks

​Processing Timeline

​Common Errors

​Sandbox Testing

​Features

​Support

Overview

How It Works

Prerequisites

Bank Account Setup

Creating a SWIFT Transfer

Response

Deposit Instructions

Transfer States

Monitoring Transfer Status

Webhooks

Processing Timeline

Common Errors

Sandbox Testing

Features

Support