Skip to main content
POST
/
api
/
withdrawals
# PayPal Withdrawal
curl -X POST https://api.swiftpay.cx/api/withdrawals \
  -H "Authorization: Bearer mp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50.00,
    "destinationType": "paypal",
    "destinationDetails": {
      "paypalEmail": "user@example.com"
    }
  }'

# Crypto Withdrawal

curl -X POST https://api.swiftpay.cx/api/withdrawals \
 -H "Authorization: Bearer mp_live_your_api_key" \
 -H "Content-Type: application/json" \
 -d '{
"amount": 100.00,
"destinationType": "crypto",
"destinationDetails": {
"cryptoCoin": "USDT",
"cryptoNetwork": "TRC20",
"cryptoAddress": "Txxxxxxxxxxxxxxxxxxxxxxx"
}
}'


{
  "success": true,
  "data": {
    "id": "wd_abc123",
    "amountInCents": 5000,
    "status": "pending",
    "destinationType": "paypal",
    "destinationDetails": "{\"paypalEmail\":\"user@example.com\"}",
    "requestedAt": "2024-01-15T10:30:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.swiftpay.cx/llms.txt

Use this file to discover all available pages before exploring further.

​
Create Withdrawal

Creates a new withdrawal request to transfer funds from your available balance.
You can only withdraw from your available balance. Reserved funds cannot be withdrawn until released.

​
Request

​
Authorization
string
required
Bearer token with your API key
​
amount
number
required
Amount to withdraw in dollars (e.g., 50.00). Must not exceed available balance.
​
destinationType
string
required
Type of withdrawal: paypal or crypto
​
destinationDetails
object
required
​
notes
string
Optional internal notes for the withdrawal.

​
Response

​
success
boolean
Whether the request was successful
​
data
object
# PayPal Withdrawal
curl -X POST https://api.swiftpay.cx/api/withdrawals \
  -H "Authorization: Bearer mp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50.00,
    "destinationType": "paypal",
    "destinationDetails": {
      "paypalEmail": "user@example.com"
    }
  }'

# Crypto Withdrawal

curl -X POST https://api.swiftpay.cx/api/withdrawals \
 -H "Authorization: Bearer mp_live_your_api_key" \
 -H "Content-Type: application/json" \
 -d '{
"amount": 100.00,
"destinationType": "crypto",
"destinationDetails": {
"cryptoCoin": "USDT",
"cryptoNetwork": "TRC20",
"cryptoAddress": "Txxxxxxxxxxxxxxxxxxxxxxx"
}
}'


{
  "success": true,
  "data": {
    "id": "wd_abc123",
    "amountInCents": 5000,
    "status": "pending",
    "destinationType": "paypal",
    "destinationDetails": "{\"paypalEmail\":\"user@example.com\"}",
    "requestedAt": "2024-01-15T10:30:00Z"
  }
}

​
Withdrawal Flow

  1. Pending: Withdrawal request created, awaiting processing
  2. Processing: Funds being transferred to your account
  3. Completed: Funds successfully transferred
  4. Failed: Transfer failed (contact support)
  5. Cancelled: Withdrawal cancelled (funds returned to balance)

​
Before Withdrawing

1

Check Available Balance

Use the Balance API to verify available funds
2

Set Up Withdrawal Method

Add a PayPal or crypto wallet in your dashboard settings
3

Create Withdrawal

Submit withdrawal request with amount and method
Pending and processing withdrawals reduce your available balance to prevent over-withdrawal.