{"templateId":"markdown","versions":[{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/accounts-and-assets/tokenization/ledger-specific/hedera-api","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/accounts-and-assets/tokenization/ledger-specific/hedera-api","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/accounts-and-assets/tokenization/ledger-specific/hedera-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/accounts-and-assets/tokenization/ledger-specific/hedera-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/accounts-and-assets/tokenization/ledger-specific/hedera-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/accounts-and-assets/tokenization/ledger-specific/hedera-api","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition"]},"type":"markdown"},"seo":{"title":"Manage Hedera tokens with the API","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":"manage-hedera-tokens-with-the-api","__idx":0},"children":["Manage Hedera tokens with the API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can perform the following token management operations in Hedera:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Explicitly associate a list of tokens with a new account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automatically associate new tokens with an account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Disassociate tokens from an account."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each of these operations involves the creation of a transaction order."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also issue Hedera tokens with a transfer order or transaction order. Transfer orders are the recommended method for sending assets. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/send-and-receive/send-assets-api"},"children":["Send assets"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"associate-tokens-with-a-hedera-account","__idx":1},"children":["Associate tokens with a Hedera account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you can send or receive fungible tokens or non-fungible tokens (NFT) with a Hedera account, you need to explicitly associate the tokens with the account. By default, new Hedera accounts are not associated with any tokens, unless a token is used to pre-fund the account when it is initialized and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hedera account Id"]}," is generated."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/accounts/ledger-specific-settings/hedera-api#initialize-the-account"},"children":["Learn more about initializing Hedera accounts"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-the-transaction-order","__idx":2},"children":["Create the transaction order"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"System change process"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All new requests to change the system state follow the same process. To familiarize yourself with this process first, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/governance/intents/manage-intents-and-approvals"},"children":["Manage intents and approvals"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To associate tokens with a Hedera account, follow the steps in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/governance/intents/manage-intents-and-approvals"},"children":["Manage intents and approvals"]},", with a transaction order payload similar to the following example."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"payload-example","__idx":3},"children":["Payload example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example shows the association of a fungible token of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ticker"]}," and a non-fungible token of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TokenId"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"payload\": {\n        \"id\": \"2ea89e96-246a-4458-8e03-1edeb1322690\",\n        \"accountId\": \"5ff7cb0b-ac4e-4e9d-85bc-bd4b027740ce\",\n        \"ledgerId\": \"hedera-testnet-january-2023\",\n        \"parameters\": {\n            \"operation\": {\n                \"tokens\": [\n                    {\n                       \"tokenId\": \"0.0.15053490\",\n                       \"type\": \"TokenId\"\n                    },\n                    {\n                        \"tickerId\": \"0c863615-0b5d-4a23-b5e8-cb39971f154a\",\n                        \"type\": \"Ticker\"\n                    }\n                ],\n                \"type\": \"TokenAssociate\"\n            },\n            \"feeStrategy\": {\n                \"priority\": \"Medium\",\n                \"type\": \"Priority\"\n            },\n            \"maximumFee\": \"100000000\",\n            \"type\": \"Hedera\"\n        },\n        \"description\": \"Hedera tx\",\n        \"customProperties\": {},\n        \"type\": \"v0_CreateTransactionOrder\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fields of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload"]}," block to note are as follows:"]},{"$$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":"Field"},"children":["Field"]},{"$$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":"code","attributes":{},"children":["accountId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal account ID of an existing Hedera account in ","Ripple Custody","."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation.tokens"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One or more tokens to associate with the account. You can use two different token identifiers:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tickerId"]},": The internal ","Ripple Custody"," token identifier. This token must be allowlisted.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/tokenization/token-management/api/allowlist-token"},"children":["Learn more about allowlisting tokens"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenId"]},": The on-chain token identifier."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TokenAssociate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.feeStrategy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fee strategy field included in the transaction order payload. For Hedera, fees are retrieved directly from the chain and customers cannot prioritize the transaction. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/reference#fee-strategy-and-maximum-fee"},"children":["Fee strategy and maximum fee"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.maximumFee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The maximum fee, in tinybar. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/reference#fee-strategy-and-maximum-fee"},"children":["Fee strategy and maximum fee"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ledger type, in this case ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hedera"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateTransactionOrder"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the transaction order is successfully approved, ","Ripple Custody"," does the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creates a transaction, to broadcast the token association on the blockchain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creates one or more transfers, to represent the separate amounts associated with the transaction, such as the cryptocurrency amount and the fees."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"automatically-associate-tokens-with-a-hedera-account","__idx":4},"children":["Automatically associate tokens with a Hedera account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can update a Hedera account to automatically associate newly-created tokens with the account. You can set the number of tokens to a number up to 1000. You do not need to associate tokens with the account that mints them, as this association is automatic."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the limit of the automatic token associations is reached, to continue associating tokens with the account, perform one of the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TokenAssociate"]}," operation including the tokens to be associated."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AccountUpdate"]}," operation to increase the value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxAutomaticTokenAssociations"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-the-transaction-order-1","__idx":5},"children":["Create the transaction order"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"System change process"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All new requests to change the system state follow the same process. To familiarize yourself with this process first, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/governance/intents/manage-intents-and-approvals"},"children":["Manage intents and approvals"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To automatically associate tokens with a Hedera account, follow the steps in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/governance/intents/manage-intents-and-approvals"},"children":["Manage intents and approvals"]},", with a transaction order payload similar to the following example."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"payload-example-1","__idx":6},"children":["Payload example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example shows the automatic association of up to five tokens with the account."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"payload\": {\n        \"id\": \"2ea89e96-246a-4458-8e03-1edeb1322690\",\n        \"accountId\": \"5ff7cb0b-ac4e-4e9d-85bc-bd4b027740ce\",\n        \"ledgerId\": \"hedera-testnet-january-2023\",\n        \"parameters\": {\n            \"operation\": {\n                \"maxAutomaticTokenAssociations\": 5,\n                \"type\": \"AccountUpdate\"\n            },\n            \"feeStrategy\": {\n                \"priority\": \"Medium\",\n                \"type\": \"Priority\"\n            },\n            \"maximumFee\": \"22991332\",\n            \"type\": \"Hedera\"\n        },\n        \"description\": \"Hedera tx\",\n        \"customProperties\": {},\n        \"type\": \"v0_CreateTransactionOrder\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fields of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload"]}," block to note are as follows:"]},{"$$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":"Field"},"children":["Field"]},{"$$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":"code","attributes":{},"children":["accountId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal account ID of an existing Hedera account in ","Ripple Custody","."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation.maxAutomaticTokenAssociations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of tokens to automatically associate with the account, between 0 and 1000."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AccountUpdate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.feeStrategy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fee strategy field included in the transaction order payload. For Hedera, fees are retrieved directly from the chain and customers cannot prioritize the transaction. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/reference#fee-strategy-and-maximum-fee"},"children":["Fee strategy and maximum fee"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.maximumFee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The maximum fee, in tinybar. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/reference#fee-strategy-and-maximum-fee"},"children":["Fee strategy and maximum fee"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateTransactionOrder"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"disassociate-tokens-from-a-hedera-account","__idx":7},"children":["Disassociate tokens from a Hedera account"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This transaction does not broadcast successfully if the balance of the associated token in the account is above zero."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-the-transaction-order-2","__idx":8},"children":["Create the transaction order"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"System change process"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All new requests to change the system state follow the same process. To familiarize yourself with this process first, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/governance/intents/manage-intents-and-approvals"},"children":["Manage intents and approvals"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To disassociate tokens from a Hedera account, follow the steps in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/governance/intents/manage-intents-and-approvals"},"children":["Manage intents and approvals"]},", with a transaction order payload similar to the following example."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"payload-example-2","__idx":9},"children":["Payload example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example shows the disassociation of a fungible token of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ticker"]}," and a non-fungible token of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TokenId"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"payload\": {\n        \"id\": \"d28a2cce-af3d-4a4e-b589-c8d61fd824b8\",\n        \"accountId\": \"5ff7cb0b-ac4e-4e9d-85bc-bd4b027740ce\",\n        \"ledgerId\": \"hedera-testnet-january-2023\",\n        \"parameters\": {\n            \"operation\": {\n                \"tokens\": [\n                    {\n                        \"tokenId\": \"0.0.15053490\",\n                        \"type\": \"TokenId\"\n                    },\n                    {\n                        \"tickerId\": \"0c863615-0b5d-4a23-b5e8-cb39971f154a\",\n                        \"type\": \"Ticker\"\n                    }\n                ],\n                \"type\": \"TokenDissociate\"\n            },\n            \"feeStrategy\": {\n                \"priority\": \"Medium\",\n                \"type\": \"Priority\"\n            },\n            \"maximumFee\": \"208340972\",\n            \"type\": \"Hedera\"\n        },\n        \"description\": \"Hedera tx\",\n        \"customProperties\": {},\n        \"type\": \"v0_CreateTransactionOrder\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fields of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload"]}," block to note are as follows:"]},{"$$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":"Field"},"children":["Field"]},{"$$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":"code","attributes":{},"children":["accountId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal account ID of an existing Hedera account in ","Ripple Custody","."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation.tokens"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One or more tokens to disassociate from the account. You can use two different token identifiers:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tickerId"]},": The internal ","Ripple Custody"," token identifier. This token must be allowlisted.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/tokenization/token-management/api/allowlist-token"},"children":["Learn more about allowlisting tokens"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenId"]},": The on-chain token identifier."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TokenDissociate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.feeStrategy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fee strategy field included in the transaction order payload. For Hedera, fees are retrieved directly from the chain and customers cannot prioritize the transaction. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/reference#fee-strategy-and-maximum-fee"},"children":["Fee strategy and maximum fee"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.maximumFee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The maximum fee, in tinybar. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/reference#fee-strategy-and-maximum-fee"},"children":["Fee strategy and maximum fee"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateTransactionOrder"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the transaction order is successfully approved, ","Ripple Custody"," does the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creates a transaction, to broadcast the token disassociation on the blockchain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creates one or more transfers, to represent the separate amounts associated with the transaction, such as the cryptocurrency amount and the fees."]}]}]}]},"headings":[{"value":"Manage Hedera tokens with the API","id":"manage-hedera-tokens-with-the-api","depth":1},{"value":"Associate tokens with a Hedera account","id":"associate-tokens-with-a-hedera-account","depth":2},{"value":"Create the transaction order","id":"create-the-transaction-order","depth":3},{"value":"Payload example","id":"payload-example","depth":4},{"value":"Automatically associate tokens with a Hedera account","id":"automatically-associate-tokens-with-a-hedera-account","depth":2},{"value":"Create the transaction order","id":"create-the-transaction-order-1","depth":3},{"value":"Payload example","id":"payload-example-1","depth":4},{"value":"Disassociate tokens from a Hedera account","id":"disassociate-tokens-from-a-hedera-account","depth":2},{"value":"Create the transaction order","id":"create-the-transaction-order-2","depth":3},{"value":"Payload example","id":"payload-example-2","depth":4}],"frontmatter":{"seo":{"title":"Manage Hedera tokens with the API"}},"lastModified":"2026-07-27T10:10:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.38/accounts-and-assets/tokenization/ledger-specific/hedera-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}