{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/v1.40/overview/blockchain/transactions/transaction-initiation","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/overview/blockchain/transactions/transaction-initiation","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/overview/blockchain/transactions/transaction-initiation","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/overview/blockchain/transactions/transaction-initiation","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/overview/blockchain/transactions/transaction-initiation","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/overview/blockchain/transactions/transaction-initiation","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/overview/blockchain/transactions/transaction-initiation","default":false,"active":true,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Transaction initiation","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":"transaction-initiation","__idx":0},"children":["Transaction initiation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section presents the different ways you can initiate blockchain transactions from a ","Ripple Custody"," account."," ","It also describes the data objects created when you initiate blockchain transactions from a ","Ripple Custody"," account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-concepts","__idx":1},"children":["Key concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The key concepts of ","Ripple Custody"," transaction initiation are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transfer order"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transaction order"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transaction"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transfer"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transfer-order","__idx":2},"children":["Transfer order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transfer order"]}," is the recommended way of initiating transactions for simple transactions, such as sending assets. The format of a transfer order is standard for all ledgers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transaction-order","__idx":3},"children":["Transaction order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transaction order"]}," provides a more complex way to initiate accounting transactions. You need to use a transaction order for transactions that are not supported by a transfer order, such as staking or deployment of smart contracts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A transfer order is effectively a wrapper around a transaction order. If you create a transfer order, ","Ripple Custody"," automatically creates the transaction order for you."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transaction-and-transfer","__idx":4},"children":["Transaction and transfer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Whichever method you use to initiate the transaction, ","Ripple Custody"," additionally creates the following internal objects to track the accounting transaction:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transaction"]},": A record of the transaction on the ledger."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transfers"]},": Separate records of the financial elements of the transaction, for example, one transfer for the transaction amount and one for fees paid."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple creates these internal objects in the following two scenarios:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For outgoing transactions: When a new transaction order is created, either manually by a user or internally by Ripple."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For incoming transactions: When you receive assets, such as a transfer of funds from a sending partner."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can see when each of these objects are created in the following workflows."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"outgoing-transaction-objects","__idx":5},"children":["Outgoing transaction objects"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transfer-order-1","__idx":6},"children":["Transfer order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This diagram shows the transaction objects created by the user and ","Ripple Custody"," during outgoing transactions initiated with a transfer order:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/transfer-order-objects.8155a84371822ccf6cc0996584493a828824c838f58930f28da959a0adbcb962.0516fa49.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transaction-order-1","__idx":7},"children":["Transaction order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This diagram shows the transaction objects created by the user and ","Ripple Custody"," during outgoing transactions initiated with a transaction order:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/transaction-order-objects.2b50e423f470659f57671c09794ee4bec202cbfd3f6a852321c7dcbac40a9dd4.0516fa49.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"incoming-transaction-objects","__idx":8},"children":["Incoming transaction objects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This diagram shows the transaction objects created by ","Ripple Custody"," during incoming transactions initiated by an external counterparty:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/incoming-transaction-objects.f3ac9046865bafac25cf1c09432920df0a047131b98e62f25dc210b66e786c5a.0516fa49.png","alt":""},"children":[]}]}]},"headings":[{"value":"Transaction initiation","id":"transaction-initiation","depth":1},{"value":"Key concepts","id":"key-concepts","depth":2},{"value":"Transfer order","id":"transfer-order","depth":3},{"value":"Transaction order","id":"transaction-order","depth":3},{"value":"Transaction and transfer","id":"transaction-and-transfer","depth":3},{"value":"Outgoing transaction objects","id":"outgoing-transaction-objects","depth":2},{"value":"Transfer order","id":"transfer-order-1","depth":3},{"value":"Transaction order","id":"transaction-order-1","depth":3},{"value":"Incoming transaction objects","id":"incoming-transaction-objects","depth":2}],"frontmatter":{"seo":{"title":"Transaction initiation"}},"lastModified":"2025-10-28T02:35:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.15/overview/blockchain/transactions/transaction-initiation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}