Skip to main content

How Do Transaction Push Notifications Work?

Gem Wallet can send a push notification when a tracked blockchain transaction settles. Notifications help you see whether an outgoing action succeeded or failed and when an incoming asset reached a wallet.

Selecting a transaction notification opens that transaction's details in the correct wallet. You can review its status, amount, date, network fee, sender or recipient, memo when present, and blockchain-explorer link.

note

A notification is a convenience, not the source of transaction status. The blockchain and its explorer determine whether a transaction is pending, successful, failed, or reverted.

Turn On Transaction Notifications​

  1. Open Gem Wallet.
  2. Select Settings.
  3. Select Notifications.
  4. Turn on Push Notifications.
  5. Allow notifications when your device displays its permission prompt.

Both the Gem Wallet toggle and the device-level notification permission must be enabled. If you previously denied permission, selecting the option again may open the system settings so you can allow notifications for Gem Wallet.

For screenshots of the settings flow, see How to Configure Your Gem Wallet Settings.

When Does Gem Wallet Send a Transaction Notification?​

A pending transaction is tracked until the network settles it. Gem Wallet sends the transaction notification after the result becomes available:

  • Successful outgoing transaction: subscribed devices receive a notification describing the completed action.
  • Successful incoming transaction: subscribed devices receive a notification that an asset or NFT was received.
  • Failed or reverted outgoing transaction: the sending wallet receives a failure notification.
  • Failed incoming transaction: no notification is sent because no asset arrived.

A settled transaction can notify every device subscribed to that wallet. Devices must have Gem Wallet notifications enabled and remain registered for push delivery.

Which Activities Can Generate Notifications?​

The notification text depends on the completed action:

ActivitySuccessful notificationFailed or reverted notification
Sent cryptoAsset and amount sent, with the recipientTransfer failed
Received cryptoAsset and amount received, with the senderNo notification
Sent or received NFTNFT sent or receivedTransfer failed for an outgoing NFT
SwapSource and destination assets and amountsSwap failed
Token approvalApproved token and spenderToken approval failed
Stake or earn depositStaked asset and amountStake failed
UnstakeUnstaked asset and amountUnstake failed
RedelegateRedelegated asset and amountRedelegation failed
Claim rewardsClaimed asset and amountClaim rewards failed
Staking or earn withdrawalWithdrawn asset and amountWithdrawal failed
TRON freeze or unfreezeFrozen or unfrozen TRX amountFreeze or unfreeze failed
Smart-contract callSent asset and destinationSmart contract failed

Filled perpetual orders can also create activity notifications for supported open and close results. Modifying an existing perpetual order or activating an asset does not generate a transaction push.

What Opens When I Select a Notification?​

A transaction notification opens the matching Transaction Details screen. If the notification belongs to another wallet, Gem Wallet opens the transaction under that wallet rather than replacing it with the wallet currently selected in the app.

The details remain tied to the transaction they were opened for, even if you switch wallets while the screen is open. Use View on to verify the result on the blockchain explorer.

Why Did I Not Receive a Notification?​

Check the following:

  1. Open Settings > Notifications and confirm Push Notifications is on.
  2. Open the device's settings and confirm notifications are allowed for Gem Wallet.
  3. Check that Focus, Do Not Disturb, battery restrictions, or background restrictions are not suppressing notifications.
  4. Confirm that the wallet containing the transaction is present on this device.
  5. Check Activity to see whether the transaction is still pending.
  6. Open the transaction on the correct blockchain explorer and verify whether it settled.
  7. Confirm the device has an internet connection.
  8. Update Gem Wallet to the latest available version.

If notification registration shows an error, keep the device online and turn Push Notifications off and on once to retry. Do not submit another blockchain transaction merely to test notification delivery.

tip

To reproduce notification navigation safely, use an existing settled transaction notification still available in the device's notification center. Select it and verify that Gem Wallet opens the matching transaction details. No new transaction is required.

Why Is There No Failure Notification for an Incoming Transfer?​

An incoming transfer appears only when another wallet submits a transaction to your address. If that transaction fails or reverts, nothing reaches your wallet, so Gem Wallet does not send an incoming failure notification.

The sender may receive a failure notification for their outgoing transaction. Ask the sender for the public transaction ID and verify it on the correct blockchain explorer.

Are Transaction Notifications the Same as Price Alerts?​

No. Transaction notifications report wallet activity such as transfers, swaps, approvals, and staking actions. Price alerts are configured separately for selected assets under Settings > Notifications > Price Alerts.

Disabling a price alert does not necessarily disable transaction notifications, and enabling transaction notifications does not automatically create price alerts.

Protect Notification Privacy​

Transaction notifications may display asset names, amounts, action types, and shortened addresses on the lock screen. Use your device's notification-preview settings if you do not want those details visible while the device is locked.

For status definitions, see Understanding Transaction Status. If a transaction remains pending, follow Why Is My Crypto Transaction Pending?.