Appearance
Event hooks
useOn* hooks for Exchange Pay side effects. Prefer state hooks when you only need current values.
When to use
Navigate to success, toast on expiry, analytics — not for rendering status or countdown.
| Need in UI | Use instead |
|---|---|
| Order / checkout / status | useExchangePayOrder |
| Countdown timer | useExchangePayOrderCountdown |
| Success summary | useExchangePayCompletedTransactionSummary |
Hooks
| Hook | When it fires |
|---|---|
useOnExchangePayOrderUpdated | Status / offchain update |
useOnExchangePayOrderCompleted | Payment succeeded — e.g. navigate to success |
useOnExchangePayOrderExpired | Local expiry timer fired — toast, navigate back, etc. |
Example
tsx
import {
useOnExchangePayOrderCompleted,
useOnExchangePayOrderExpired,
} from '@swapped/connect-sdk/react'
function ExchangePaySideEffects({
onComplete,
onExpired,
}: {
onComplete: () => void
onExpired: () => void
}) {
useOnExchangePayOrderCompleted(() => onComplete())
// Payload includes `{ order }` if you need the expired order details.
useOnExchangePayOrderExpired(() => {
// e.g. toast.info('Order expired, please try again')
onExpired() // navigate back to deposit
})
return null
}See Errors for failure mapping, and Events (React) for session listeners.