{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/wallet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Transactions overview","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com/products/custody","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-overview","__idx":0},"children":["Transactions overview"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"In this section"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/user-interface/transactions/manage-transactions"},"children":["Manage transactions"]}," – Create, monitor, and manage transactions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/user-interface/transactions/raw-signing"},"children":["Raw signing"]}," – Sign custom transaction payloads"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/user-interface/transactions/cross-chain-transactions"},"children":["Cross-chain transactions"]}," – Transfer assets across EVM chains"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/user-interface/transactions/estimating-transaction-fees"},"children":["Estimating transaction fees"]}," – Understand and estimate gas fees"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/user-interface/transactions/external-ids"},"children":["External IDs"]}," – Ensure idempotent requests for vaults, wallets, and transactions"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A transaction of digital assets refers to the transfer of ownership of digital assets from one party to another. Assets may be transferred between decentralized applications (dApps), individuals or organizations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After transactions are made, they are verified and recorded as entries on a blockchain network, which is essentially a digital public ledger with no central authority (such as a bank). These entries can be viewed by anyone and cannot be altered."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Digital asset transactions are secured through cryptography. See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/user-interface/wallets/wallets-overview"},"children":["Wallets guide"]}," for more information on cryptographic keys and how they are used to authenticate transactions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transaction-status-flow","__idx":1},"children":["Transaction Status Flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you create a transaction in Wallet-as-a-Service (Palisade), it flows through several stages from initial request to final confirmation on the blockchain. Understanding these stages helps you track transaction progress, handle delays, and troubleshoot issues."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every transaction follows a predictable path through these stages:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"REQUESTED → POLICY CHECK → APPROVAL (optional) → COMPILATION → SIGNATURE → PUBLISHING → CONFIRMATION → CONFIRMED\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-complete-stage-breakdown","__idx":2},"children":["The Complete Stage Breakdown"]},{"$$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":"Stage"},"children":["Stage"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What Happens"},"children":["What Happens"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REQUESTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction created"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your transaction request is received and queued for processing"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POLICY_CHECK_PENDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Policy validation in progress"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wallet-as-a-Service (Palisade) verifies the transaction against your configured policies (wallet limits, daily limits, etc.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POLICY_CHECK_PASSED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Policy validation passed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction cleared policy checks and is eligible to proceed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["APPROVAL_CHECK_PENDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Awaiting approvals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If your transaction requires approvals, it waits here for authorized users to approve it"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["APPROVAL_CHECK_PASSED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All approvals obtained"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required approvals have been granted"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["COMPILATION_PENDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preparing for blockchain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction is being prepared and encoded for the target blockchain"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["COMPILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blockchain-ready"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction is now in blockchain format and ready for signing"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SIGNATURE_PENDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Waiting for signature"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction is waiting to be cryptographically signed by your wallet"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SIGNED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature complete"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction has been signed and is ready to submit to the blockchain"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PUBLISH_PENDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submitting to blockchain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction is being submitted to the blockchain network"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PUBLISHED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["On the blockchain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction has been received by the blockchain network"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CONFIRMATION_PENDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Waiting for finality"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blockchain is processing the transaction; awaiting block confirmation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CONFIRMED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction complete"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction is finalized on the blockchain (terminal state)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"important-notes","__idx":3},"children":["Important Notes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Linear Progression"]},": Transactions always move forward through these stages—they never go backward. Once a stage is passed, the transaction continues forward."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approvals Are Optional"]},": If your wallet doesn't require approvals, the transaction skips the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APPROVAL_CHECK_PENDING"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APPROVAL_CHECK_PASSED"]}," stages entirely."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Asynchronous Processing"]},": Status updates happen automatically as Wallet-as-a-Service (Palisade) and the blockchain process your transaction. You don't need to take action between stages."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Failure States"]},": At any stage, a transaction may be rejected or fail:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REJECTED"]},": The transaction was denied (e.g., policy rejection, approval denial)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["FAILED"]},": A technical error occurred during processing"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"monitoring-transaction-status","__idx":4},"children":["Monitoring Transaction Status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can check transaction status through:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dashboard"]},": View status in the Transactions tab of your wallet"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API"]},": Use the transactions API to programmatically fetch current status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhooks"]},": Get real-time notifications when transactions change status (see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/user-interface/integrations/overview"},"children":["Webhooks"]},")"]}]}]},"headings":[{"value":"Transactions overview","id":"transactions-overview","depth":1},{"value":"Transaction Status Flow","id":"transaction-status-flow","depth":2},{"value":"The Complete Stage Breakdown","id":"the-complete-stage-breakdown","depth":2},{"value":"Important Notes","id":"important-notes","depth":2},{"value":"Monitoring Transaction Status","id":"monitoring-transaction-status","depth":2}],"frontmatter":{"title":"Transactions overview","seo":{"title":"Transactions overview"}},"lastModified":"2026-02-27T16:34:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/wallet/user-interface/transactions/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}