{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/wallet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Receive assets","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"receive-assets","__idx":0},"children":["Receive assets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A wallet can receive funds as soon as Ripple Custody (Wallet) provisions it. New wallets are deposit-only: they receive funds but can't send them until you ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/get-started/console/unlock-outgoing-transactions"},"children":["unlock outgoing transactions"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"find-your-wallets-receive-address-via-the-console","__idx":1},"children":["Find your wallet's receive address via the console"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To receive assets, send them to the wallet's address."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the wallet. The wallet address appears at the top of the wallet page, and in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["General"]}," under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wallet Address"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the wallet address."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send funds to that address from an exchange, another wallet, or any external source."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for on-chain confirmation. The balance appears on the wallet's asset list once the transaction confirms on the blockchain."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Through the API, the wallet's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," appears in the wallet response once its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PROVISIONED"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/vaults-and-wallets/wallets/manage-wallets-api#get-a-wallet-via-the-api"},"children":["Manage wallets via the API"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-incoming-transactions-appear","__idx":2},"children":["How incoming transactions appear"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Custody (Wallet) detects incoming transfers through blockchain monitoring and records each one as a transaction in the wallet's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions"]}," tab and in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions"]}," in the main menu. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/transactions/view-and-track-transactions"},"children":["View transactions in the console"]},", or list them through the API with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/transactions/view-and-track-transactions#list-transactions-via-the-api"},"children":["Track transactions via the API"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Until Ripple Custody (Wallet) releases an incoming amount to the available balance or freezes it, the amount counts toward the wallet's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["pending"]}," balance. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/vaults-and-wallets/wallets/understanding-balances"},"children":["Understanding balances"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"contract-token-deposits","__idx":3},"children":["Contract-token deposits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When Ripple Custody (Wallet) records an incoming contract-token transfer detected through blockchain monitoring, the top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination"]}," holds your recipient wallet address, the top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qty"]}," holds the transferred token quantity, and the top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["asset"]}," holds the token."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Outgoing contract-token transfers work differently — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/transactions/view-and-track-transactions#read-contract-token-transfers-via-the-api"},"children":["Reading contract-token transfer fields"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deposits-from-more-than-one-sender","__idx":4},"children":["Deposits from more than one sender"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A single blockchain transaction can send the same asset to one of your wallets from several addresses, for example an exchange batch payout. Ripple Custody (Wallet) records this as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["one"]}," deposit transaction, with the combined quantity in the top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qty"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["origin"]}," (and the deprecated ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["originAddress"]},") holds only one sender: the first contributing sender in the blockchain transaction. To find every sender, read ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmedAssetChanges"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep entries with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["purpose: TRANSFER"]}," whose ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["asset"]}," matches the transaction asset and whose ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination"]}," is your receiving wallet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Skip entries with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["purpose: FEE"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source.address"]}," from each remaining entry. The same address can appear more than once."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the console, the wallet's transaction list shows the number of senders for these deposits, for example ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3 available senders"]},", and the transaction details list each sender address."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Older deposits"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For deposits confirmed before this change, the sender list shows only the sender data that Ripple Custody (Wallet) already recorded, and the order of senders isn't guaranteed. The console count and list describe the senders available in the record, which might not be every sender in the blockchain transaction."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"frozen-deposits","__idx":5},"children":["Frozen deposits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A deposit can arrive frozen, or you can freeze it after it arrives. Frozen funds stay in the wallet but move from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["available"]}," balance to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["frozen"]}," balance. Users can't spend, transfer, or include frozen funds in outgoing transactions until you unfreeze them."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Automatic freeze."]}," If a wallet has ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Freeze transactions by default"]}," enabled, Ripple Custody (Wallet) freezes every new deposit on arrival. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/compliance/freeze-and-unfreeze-transactions#enable-automatic-freeze-on-a-wallet-via-the-console"},"children":["Enable automatic freeze on a wallet"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Travel Rule."]}," If a wallet has an inbound Travel Rule rule, Ripple Custody (Wallet) checks each deposit the rule covers and freezes it unless your compliance team has accepted the matching Travel Rule message. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/compliance/travel-rule/travel-rule-transactions#inbound-deposits"},"children":["Travel Rule transactions: Inbound deposits"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manual freeze."]}," You can freeze any incoming transaction for review. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/compliance/transaction-freeze"},"children":["Configure transaction freeze controls"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":6},"children":["Related topics"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/get-started/console/create-your-first-wallet#fund-your-wallet"},"children":["Create your first wallet"]}," — Fund a new wallet"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/get-started/console/unlock-outgoing-transactions"},"children":["Unlock outgoing transactions"]}," — Enable a deposit-only wallet to send"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/transactions/send-assets"},"children":["Send assets"]}," — Send funds from a wallet"]}]}]},"headings":[{"value":"Receive assets","id":"receive-assets","depth":1},{"value":"Find your wallet's receive address via the console","id":"find-your-wallets-receive-address-via-the-console","depth":2},{"value":"How incoming transactions appear","id":"how-incoming-transactions-appear","depth":2},{"value":"Contract-token deposits","id":"contract-token-deposits","depth":3},{"value":"Deposits from more than one sender","id":"deposits-from-more-than-one-sender","depth":2},{"value":"Frozen deposits","id":"frozen-deposits","depth":2},{"value":"Related topics","id":"related-topics","depth":2}],"frontmatter":{"title":"Receive assets","seo":{"title":"Receive assets"}},"lastModified":"2026-10-09T11:09:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/wallet/transactions/receive-assets","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}