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": "[email protected]"
    }
  }'

# 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\":\"[email protected]\"}",
    "requestedAt": "2024-01-15T10:30:00Z"
  }
}

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": "[email protected]"
    }
  }'

# 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\":\"[email protected]\"}",
    "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.