{"templateId":"markdown","versions":[{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/transactions/overview","default":true,"active":true,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/transactions/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/transactions/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/transactions/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/transactions/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/transactions/overview","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Transactions and transfers","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":"transactions-and-transfers","__idx":0},"children":["Transactions and transfers"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Executive summary"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions flow through governance approval, cryptographic signing, and blockchain broadcast, with full status tracking at every stage."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Every transaction passes through policy checks before signing (governance cannot be bypassed)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fee strategies let you balance cost vs. confirmation speed per transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Both hot vaults (online signing) and cold vaults (air-gapped) are supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Status tracking covers internal processing through blockchain finality."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Why this matters"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Understanding the transaction lifecycle is essential for operations and integration. Every transaction is gated by your policies—this is how you enforce spending limits, multi-party approval, and compliance controls. Fee strategies directly impact cost and user experience (under-priced transactions may be delayed; over-priced wastes money). Status tracking enables real-time monitoring and reconciliation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["For architects and operators"]},": Monitor transaction status distribution to identify bottlenecks (many in \"Pending\" = approval backlog; many in \"Preparing\" = fee issues). Configure appropriate fee strategies per use case — high-priority for customer withdrawals, lower priority for internal treasury movements."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Prerequisites"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before reading this page, you should understand:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/accounts/overview"},"children":["Accounts"]}," - How accounts and addresses work in ","Ripple Custody"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/overview/security-model"},"children":["Security"]}," - The security model including governance and signing"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-a-blockchain-transaction","__idx":1},"children":["What is a blockchain transaction?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A blockchain transaction is a digitally signed instruction that requests a change on a distributed ledger. Unlike traditional financial systems where a central authority processes transfers, blockchain transactions are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cryptographically signed"]},": The sender proves ownership of their assets by signing the transaction with their private key (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/identity-and-access/authentication/overview"},"children":["Authentication"]}," for details on how signing works)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Broadcast to a network"]},": The transaction is sent to multiple nodes (computers) that validate it"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recorded permanently"]},": Once confirmed, the transaction becomes part of an immutable record"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows a simplified view of how a blockchain transaction works:"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n A[\"User or service caller\"] -->|\"1. Submit signed intent\"| B[\"API Gateway\"]\n B -->|\"2. Queue workflow\"| C[\"Intent workflow\"]\n C -->|\"3. Policy evaluation and attestation\"| D[\"Notary\"]\n D -->|\"4. Attested operation\"| E[\"Vault\"]\n E -->|\"5. Signed transaction\"| F[\"Ledger Accounting\"]\n F -->|\"6. Broadcast and monitor\"| G[\"Blockchain network\"]\n","diagramHtml":"

1. Submit signed intent

2. Queue workflow

3. Policy evaluation and attestation

4. Attested operation

5. Signed transaction

6. Broadcast and monitor

User or service caller

API Gateway

Intent workflow

Notary

Vault

Ledger Accounting

Blockchain network

","diagramHtmlDark":"

1. Submit signed intent

2. Queue workflow

3. Policy evaluation and attestation

4. Attested operation

5. Signed transaction

6. Broadcast and monitor

User or service caller

API Gateway

Intent workflow

Notary

Vault

Ledger Accounting

Blockchain network

"},"children":["flowchart LR\n A[\"User or service caller\"] -->|\"1. Submit signed intent\"| B[\"API Gateway\"]\n B -->|\"2. Queue workflow\"| C[\"Intent workflow\"]\n C -->|\"3. Policy evaluation and attestation\"| D[\"Notary\"]\n D -->|\"4. Attested operation\"| E[\"Vault\"]\n E -->|\"5. Signed transaction\"| F[\"Ledger Accounting\"]\n F -->|\"6. Broadcast and monitor\"| G[\"Blockchain network\"]\n"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submit signed intent"]},": The user or service caller submits a transaction request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Queue workflow"]},": ","Ripple Custody"," accepts the request for asynchronous processing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Policy evaluation and attestation"]},": The notary verifies signatures, evaluates policy, and signs the trusted-state attestation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Attested operation"]},": The vault receives the notary-attested operation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Signed transaction"]},": The vault verifies the attestation, builds the ledger-specific transaction, and signs it through its KMS backend."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Broadcast and monitor"]},": Ledger Accounting broadcasts the transaction and tracks ledger status through blockchain indexing services."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"accounting-transactions-in-ripple-custody","__idx":2},"children":["Accounting transactions in ","Ripple Custody"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In ","Ripple Custody",", an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["accounting transaction"]}," is any operation that affects the balance or the system's state (such as a configuration change). This includes blockchain transactions as well as internal tracking of incoming funds."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The types of accounting transactions you can perform depend on the blockchain you're using:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Transaction type"},"children":["Transaction type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example use cases"},"children":["Example use cases"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Native currency transfer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send the blockchain's base currency (e.g., ETH, BTC, XRP) to another address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Paying vendors, treasury management, customer withdrawals"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token transfer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send tokens issued on a blockchain (e.g., ERC-20, SPL tokens) to another address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stablecoin payments, loyalty token distribution"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Smart contract call"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Execute code stored on a blockchain to perform complex operations"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DeFi interactions, NFT minting, custom business logic"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Staking operation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lock assets to participate in network consensus and earn rewards"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delegate tokens to validators, claim staking rewards"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Not all blockchains support all transaction types. For details on what each blockchain supports, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/reference/supported-ledgers"},"children":["Supported ledgers"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For guides on performing these operations, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/send-and-receive/send-assets-ui"},"children":["Send assets (UI)"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/send-and-receive/send-assets-api"},"children":["Send assets (API)"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transaction-lifecycle-overview","__idx":3},"children":["Transaction lifecycle overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you initiate a transaction in ","Ripple Custody",", it passes through several stages before reaching the blockchain:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Phase"},"children":["Phase"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What happens"},"children":["What happens"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key components"},"children":["Key components"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1. Initiation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User submits a transaction request (transfer order or transaction order)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API Gateway, Web UI"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2. Governance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The notary evaluates policy and verifies whether the transaction requires additional approvals or exceeds spending limits."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notary, policies"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3. Signing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Once approved and attested, the vault verifies the notary attestation and signs the blockchain transaction through its KMS backend."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notary, vault, KMS"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["4. Broadcast"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The signed transaction is sent to the blockchain network."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ledger Accounting, blockchain nodes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5. Confirmation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The blockchain includes the transaction in a block and the system updates balances and status."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blockchain indexing services, Ledger Accounting, PostgreSQL"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Key Takeaway"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every transaction goes through governance approval and notary attestation before signing. The vault independently verifies the notary attestation before it signs the blockchain transaction, ensuring no transaction can bypass policy controls."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the complete technical flow with detailed sequence diagrams, API calls, and UI screenshots, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/send-and-receive/send-assets-ui"},"children":["Send assets (UI)"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/send-and-receive/send-assets-api"},"children":["Send assets (API)"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":4},"children":["Next steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This overview introduces the transaction lifecycle. For detailed information, see the following pages:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Page"},"children":["Page"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/initiation"},"children":["Transaction workflow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Start with the major transaction actions and learn when to use transfer orders or transaction orders."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/processing"},"children":["Transaction status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Understand what happens after initiation, including status progression, vault signing flows, fees, and finality."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/reference"},"children":["Transaction reference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Look up fee strategies by ledger, finality settings, status definitions, troubleshooting notes, and glossary terms."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/send-and-receive/sending-assets"},"children":["Sending assets"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find the UI and API procedures for outbound transfers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/send-and-receive/receiving-assets"},"children":["Receiving assets"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find the UI and API procedures for incoming transfers and quarantine release."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/viewing-assets"},"children":["Viewing assets"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View the transaction and transfer records created when assets are sent or received."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/cancel-and-replace"},"children":["Cancel or replace a transaction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel a transaction before resources are fully allocated, or replace supported Bitcoin and Ethereum transactions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/smart-contracts"},"children":["Smart contracts + DApps"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find the UI and API procedures for smart contract operations and WalletConnect DApps."]}]}]}]}]}]},"headings":[{"value":"Transactions and transfers","id":"transactions-and-transfers","depth":1},{"value":"What is a blockchain transaction?","id":"what-is-a-blockchain-transaction","depth":2},{"value":"Accounting transactions in Ripple Custody","id":"accounting-transactions-in-ripple-custody","depth":2},{"value":"Transaction lifecycle overview","id":"transaction-lifecycle-overview","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Transactions and transfers"}},"lastModified":"2026-08-04T20:25:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/transactions/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}