Available Events

Receive real-time updates about transactions and wallet events.

Event Types

Subscribe to these events to receive real-time notifications:

  • wallet.connected
    Triggered when a user connects their wallet to your application
    {
      "wallet_address": "rl_1234...",
      "user_id": "user_123",
      "connected_at": "2025-03-25T12:00:00Z",
    }
  • wallet.disconnected
    Triggered when a user disconnects their wallet from your application
    {
      "wallet_address": "rl_1234...",
      "user_id": "user_123",
      "disconnected_at": "2025-03-25T12:00:00Z",
    }

  • charge.successful
    Triggered when a charge is successfully processed
    {
      "transaction_id": "tx_123",
      "reload_credits": 100,
      "platform_credits": 1000,
      "usd_amount": 1,
      "type": "usage",
      "status": "completed",
      "created_at": "2025-03-25T12:00:00Z",
    }

  • charge.failed
    Triggered when a charge fails to process
    {
      "error": "Insufficient balance",
      "amount_requested": 100,
      "amount_type": "platform_credits",
      "timestamp": "2025-03-25T12:00:00Z",
    }

  • transaction.refunded
    Triggered when a transaction is refunded
    {
      "original_transaction_id": "tx_123",
      "refund_transaction_id": "tx_124",
      "amount": 100,
      "platform_credits": 1000,
      "reason": "Service unavailable",
      "created_at": "2025-03-25T12:00:00Z",
    }