{"templateId":"markdown","versions":[{"version":"v1.41","label":"v1.41 STS","link":"/products/custody/v1.41/concepts/transactions","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/v1.40/concepts/transactions","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/concepts/transactions","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/concepts/transactions","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/concepts/transactions","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/concepts/transactions","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","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","__idx":0},"children":["Transactions"]},{"$$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/v1.34/concepts/accounts"},"children":["Accounts"]}," - How accounts and addresses work in ","Ripple Custody"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/concepts/security"},"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/v1.34/concepts/authentication"},"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] -->|1. Sign & submit| B[Custody Platform]\n B -->|2. Apply governance| B\n B -->|3. Broadcast| C[Blockchain Network]\n C -->|4. Confirm| D[Permanent Record]\n","diagramHtml":"

1. Sign & submit

2. Apply governance

3. Broadcast

4. Confirm

User

Custody Platform

Blockchain Network

Permanent Record

","diagramHtmlDark":"

1. Sign & submit

2. Apply governance

3. Broadcast

4. Confirm

User

Custody Platform

Blockchain Network

Permanent Record

"},"children":["flowchart LR\n A[User] -->|1. Sign & submit| B[Custody Platform]\n B -->|2. Apply governance| B\n B -->|3. Broadcast| C[Blockchain Network]\n C -->|4. Confirm| D[Permanent Record]\n"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign & submit"]},": The user creates and signs a transaction request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apply governance"]},": ","Ripple Custody"," validates the request against policies and obtains required approvals."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Broadcast"]},": The signed transaction is sent to the blockchain network."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Confirm"]},": Network nodes validate and add the transaction to a block, creating a permanent record."]}]},{"$$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/v1.34/support/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/v1.34/ui/accounting/send-assets"},"children":["Send assets (UI)"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/api/accounting/send-assets"},"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 system checks policies: Does this transaction require additional approvals? Does it exceed spending limits?"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Governance Engine, 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, the transaction is cryptographically signed"]},{"$$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":["Indexer, 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"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indexer, Database"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Key Takeaway"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every transaction goes through governance approval before signing. The notary validates that the governance engine authorized the transaction before the vault signs it, 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/v1.34/ui/accounting/send-assets"},"children":["Send assets (UI)"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/api/accounting/send-assets"},"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/v1.34/concepts/transactions-initiation"},"children":["Transaction initiation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Learn how to start transactions using transfer orders (simple) or transaction orders (advanced). Includes decision guide and transaction object diagrams."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/concepts/transactions-processing"},"children":["Transaction processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Understand what happens after initiation: status progression, vault signing flows (hot vs cold), fee strategies, and finality."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/concepts/transactions-reference"},"children":["Transactions reference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lookup tables for fee strategies by ledger, finality settings by network, status definitions, troubleshooting, and glossary."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send assets: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/ui/accounting/send-assets"},"children":["UI"]}," | ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/api/accounting/send-assets"},"children":["API"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Step-by-step how-to guide with UI and API workflows."]}]}]}]}]}]},"headings":[{"value":"Transactions","id":"transactions","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"}},"lastModified":"2026-04-07T19:14:09.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.34/concepts/transactions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}