Skip to main content
POST
https://api-staging.fossapay.com
/
v1
/
transfers
/
crypto
Crypto Transfer
curl --request POST \
  --url https://api-staging.fossapay.com/v1/transfers/crypto \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "customerId": "<string>",
  "recipient": "<string>",
  "network": "<string>",
  "currency": "<string>",
  "amount": 123
}
'
{
  "status": true,
  "message": "processing crypto transaction",
  "data": {
    "token": {
      "symbol": "usdc",
      "amount": 100.50
    },
    "network": "solana",
    "recipientAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "status": "processing"
  }
}

​
Request

​
x-api-key
string
required
API Key for authentication
​
customerId
string
required
UUID of the customer making the transfer
​
recipient
string
required
Recipient wallet address
​
network
string
required
The blockchain network for the transfer. Must be one of: solana, evm
​
currency
string
required
The cryptocurrency to transfer. Must be one of: usdc, usdt
​
amount
number
required
The amount to transfer

​
Request Example

curl -X POST https://api-staging.fossapay.com/v1/transfers/crypto \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "550e8400-e29b-41d4-a716-446655440000",
    "recipient": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
    "network": "solana",
    "currency": "usdc",
    "amount": 100.50
  }'

const transfer = await client.cryptoTransfers.execute({
  customerId: '550e8400-e29b-41d4-a716-446655440000',
  recipient: '0x71C7656EC7ab88b098defB751B7401B5f6d8976F',
  network: 'solana',
  currency: 'usdc',
  amount: 100.50
});

​
Response

{
  "status": true,
  "message": "processing crypto transaction",
  "data": {
    "token": {
      "symbol": "usdc",
      "amount": 100.50
    },
    "network": "solana",
    "recipientAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "status": "processing"
  }
}

{
  "status": false,
  "message": "Bad request",
  "error": "Invalid customer ID"
}

{
  "status": false,
  "message": "Internal server error",
  "error": "Transaction processing failed"
}