Swipelux

Track Status

Real-time notifications for balance and transfer updates

Monitor balance changes and transfer status in real-time using webhooks.

Configure Webhooks

Not authenticatedAuthenticate first
PATCH/v1/webhooks
Copy as

Set up webhook notifications to receive instant updates when balances change or transfers complete.

Essential Events

Track the two most important events for any integration:

Balance Updated

Triggered whenever a wallet balance changes due to incoming funds, outgoing transfers, or settlements.

Event payload:

{
  "type": "balance.updated",
  "data": {
    "wallet_id": "wlt_abc123",
    "customer_id": "cus_abc123",
    "balance": "1250.50",
    "currency": "USDC",
    "rail": "ethereum",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Transfer Completed

Triggered when a transfer, payin, or payout successfully completes.

Event payload:

{
  "type": "transfer.completed",
  "data": {
    "id": "tr_xyz789",
    "from": "cus_abc123",
    "to": "cus_abc456",
      "amount": "100.00",
      "currency": "USDC",
    "rail": "polygon",
    "state": "completed",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Transfer Failed

Triggered when a transfer fails or is rejected.

Event payload:

{
  "type": "transfer.failed",
  "data": {
    "id": "tr_xyz789",
    "from": "cus_abc123",
    "to": "cus_abc456",
    "amount": "100.00",
    "currency": "USDT",
    "rail": "tron",
    "state": "failed",
    "error": "Insufficient balance",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

On this page