Event hooks

useOn* hooks for Cash App side effects. Prefer state hooks when you only need current values.

When to use

Navigate to success, toast on failure or expiry, analytics — not for rendering status or countdown.

Need in UI	Use instead
Order / checkout / status	useCashAppOrder
Countdown timer	useCashAppOrderCountdown
Success summary	useCashAppCompletedTransactionSummary

Hooks

Hook	When it fires
useOnCashAppOrderCompleted	Payment succeeded — e.g. navigate to success
useOnCashAppOrderFailed	Payment failed — toast, navigate back, etc.
useOnCashAppOrderExpired	Local expiry timer fired — toast, navigate back, etc.
useOnCashAppDepositStatus	Optional raw status (pending / success / failure)

These hooks are provider-free.

Example

import {
  useOnCashAppOrderCompleted,
  useOnCashAppOrderExpired,
  useOnCashAppOrderFailed,
} from '@swapped/connect-sdk/react'

function CashAppSideEffects({
  onComplete,
  onExpired,
  onFailed,
}: {
  onComplete: () => void
  onExpired: () => void
  onFailed: () => void
}) {
  useOnCashAppOrderCompleted(() => onComplete())

  useOnCashAppOrderFailed(() => {
    onFailed()
  })

  useOnCashAppOrderExpired(() => {
    onExpired()
  })

  return null
}

See Errors for failure mapping, and Events (React) for session listeners.