{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["openapiLink"]},"type":"markdown"},"seo":{"title":"Tutorial: Make escrow transactions","description":"Tilia Wallet Developer Documentation","siteUrl":"https://thunes-tilia-docs.redocly.app/","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":"tutorial-make-escrow-transactions","__idx":0},"children":["Tutorial: Make escrow transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this tutorial, you create an invoice between users"," ","using tokens for a transaction with escrow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Allow about 15 minutes to complete this tutorial."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In an escrow transaction, payment is received from the buyer by an escrow agent who is not"," ","part of the transaction. The escrow agent holds the payment until the conditions of the sale"," ","have been met."," ","For example, the satisfactory delivery of a product or service."," ","When the conditions of sale have been met, the escrow agent delivers the payment to the seller."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As such, unlike a standard transaction, an escrow transaction requires an extra step"," ","before moving payment from the payer to the recipient to allow for fulfillment of the escrow terms."," ","This tutorial demonstrates how Tilia services can act as an escrow agent and support escrow transactions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows a successful escrow transaction process."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/tutorial-user-to-user-escrow-transaction-flow-completed.23aae020cfab24c366f2997bb69c6f1c99f52cf40f890ee1d45418e48fd473f6.9c1bb791.png","alt":"User to user escrow transaction flow"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-operations-in-this-tutorial","__idx":1},"children":["API operations in this tutorial"]},{"$$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":{"align":"left","data-label":"Tutorial interaction"},"children":["Tutorial interaction"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"API operations used"},"children":["API operations used"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Scope"},"children":["Scope"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#create-a-user-to-user-escrow-invoice"},"children":["Create a user-to-user escrow transaction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/escrow-transaction/createescrowtransaction","text":"Create an escrow transaction"},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["write_invoices"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#commit-escrow-transaction"},"children":["Commit escrow transaction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/escrow-transaction/commitescrowtransaction","text":"Commit an escrow transaction"},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["write_invoices"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#cancel-escrow-transaction"},"children":["Cancel escrow transaction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/escrow-transaction/cancelescrowtransaction","text":"Cancel an escrow transaction"},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["write_invoices"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"to-complete-this-tutorial","__idx":2},"children":["To complete this tutorial"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This tutorial uses the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collection from the"," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.postman.com/tilia-docs-testing/workspace/get-started-using-tilia-services/overview"},"children":["shared Postman workspace"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To complete this tutorial successfully:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure the software described in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/tutorial_get_started"},"children":["Get started with the tutorials"]}," ","has been installed on your system and configured."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure that you have initialized the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tilia Client Info"]}," environment variables by running the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts"},"children":["User account tutorials"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Postman:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tilia tutorial workspace"]}," you created in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/tutorial_get_started"},"children":["Get started with the tutorials"]}," for this tutorial."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure you have the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collection forked to your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tilia tutorial workspace"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure that you've selected the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tilia Client Info"]}," environment and confirmed that it has:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your Tilia developer credentials."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All of the user-related environment variables with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Current values"]}," defined."]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tilia tutorial workspace"]},", open the list of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Collections"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the list of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Collections"]},", expand the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collection."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If it's been more than an hour since you last got an access token for this collection,"," ","get a new one as described in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions#get-an-access-token"},"children":["Tutorial: Transactions overview"]},","," ","and then return to continue here."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-user-to-user-escrow-invoice","__idx":3},"children":["Create a user-to-user escrow invoice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This exercise creates a user-to-user invoice with an escrow requirement."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The tutorial starts after collecting the necessary information about the users who are participating in the transaction."," ","That information can be combined with the line-items to create the invoice."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creating an invoice starts with collecting all the required information,"," ","and then sending it to Tilia to create the complete invoice."," ","The data is assembled into the following object to send in the request body."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An escrow invoice needs the following information:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A summary description of the invoice"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The product information"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["payer's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]},": from the paying user's account information"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source_wallet_id"]},": the wallet ID of the payer's wallet."," ","If omitted, the default wallet for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]}," is used."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_account_id"]},": the recipient's account ID, retrieved from the recipient or catalog."," ","If this property is used, the default wallet is used."," ","If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_account_id"]}," is used, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_wallet_id"]}," can be omitted."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_wallet_id"]},": the recipient's wallet to receive the tokens from the sale."," ","This is the value used in this exercise."," ","If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_wallet_id"]}," is used, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_account_id"]}," can be omitted."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This information is then collected in the following object to send in the request body to"," ","create the escrow invoice."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"account_id\": \"{{payers_account_id}}\",\n  \"description\": \"Digital product order with escrow\",\n  \"line_items\": [\n    {\n      \"amount\": 350000,\n      \"currency\": \"TIL\",\n      \"transaction_type\": \"user_to_user\",\n      \"description\": \"In-game digital bundle w/escrow\",\n      \"recipients\": [\n        {\n          \"source_wallet_id\": \"{{payers_wallet_id}}\",\n          \"destination_wallet_id\": \"{{recipients_wallet_id}}\"\n        }\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To send this information and create a new user-to-user escrow transaction, in Postman:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collection, in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Escrow transaction - completed"]}," folder,"," ","open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a user-to-user escrow transaction"]}," request."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the request ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}," tab, notice that it has the information described previously."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a user-to-user escrow transaction"]}," request, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the response returns, open the response ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}," tab below the request to review the response body details."]}]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Show a typical response body with the transaction details."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"status\": \"Success\",\n    \"message\": [],\n    \"codes\": [],\n    \"payload\": {\n        \"id\": \"esc_2ZHRweUDyUY2PW2vCuKtSExL3uH\",\n        \"account_id\": \"acct_2Ym84qq2ieeaZkOHUM1xeF8uJtu\",\n        \"escrow_invoice_id\": \"d6627cf1-32eb-4695-8bef-b748e34758fa\",\n        \"commit_invoice_id\": \"\",\n        \"cancel_invoice_id\": \"\",\n        \"status\": \"OPEN\",\n        \"integrator\": \"tilia-test\",\n        \"created\": \"2023-12-08T23:14:17Z\",\n        \"updated\": \"2023-12-08T23:14:17Z\",\n        \"escrow_invoice\": {\n            \"invoice_id\": \"d6627cf1-32eb-4695-8bef-b748e34758fa\",\n            \"integrator\": \"tilia-test\",\n            \"account_id\": \"acct_2Ym84qq2ieeaZkOHUM1xeF8uJtu\",\n            \"invoice_type\": \"user_purchase_escrow_virtual\",\n            \"reference_type\": \"\",\n            \"reference_id\": \"\",\n            \"transfer_id\": \"\",\n            \"session_id\": \"\",\n            \"state\": \"OPEN\",\n            \"description\": \"Digital product order with escrow\",\n            \"failure_code\": \"\",\n            \"failure_reason\": \"\",\n            \"created\": \"2023-12-08T23:14:17Z\",\n            \"updated\": \"2023-12-08T23:14:17Z\",\n            \"payment_methods\": {\n                \"41a64965-f990-4323-8781-ec56c5e365fc\": {\n                    \"payment_method_id\": \"41a64965-f990-4323-8781-ec56c5e365fc\",\n                    \"payment_method\": {\n                        \"id\": \"41a64965-f990-4323-8781-ec56c5e365fc\",\n                        \"account_id\": \"acct_2Ym84qq2ieeaZkOHUM1xeF8uJtu\",\n                        \"method_class\": \"standard\",\n                        \"display_string\": \"Standard TIL wallet\",\n                        \"provider\": \"wallet\",\n                        \"psp_reference\": \"6e4dc9f9-b3d7-4752-866e-367d9c67b56b\",\n                        \"psp_hash_code\": \"\",\n                        \"processing_currency\": \"TIL\",\n                        \"pm_state\": \"ACTIVE\",\n                        \"integrator\": \"tilia-test\",\n                        \"created\": \"2023-11-27 21:06:46\",\n                        \"updated\": \"2023-11-27 21:06:46\",\n                        \"tags\": [\n                            {\n                                \"tag_id\": \"paytag_2Ym84lpfGISzkfFeQRiKDCmn1uD\",\n                                \"resource_type\": \"payments.payment_method.id\",\n                                \"resource_id\": \"41a64965-f990-4323-8781-ec56c5e365fc\",\n                                \"account_id\": \"acct_2Ym84qq2ieeaZkOHUM1xeF8uJtu\",\n                                \"namespace\": \"payment_method\",\n                                \"tag\": \"virtual\",\n                                \"status\": \"ACTIVE\",\n                                \"integrator\": \"tilia-test\",\n                                \"created\": \"2023-11-27T21:06:45.942729Z\",\n                                \"updated\": \"2023-11-27T21:06:45.942729Z\"\n                            },\n                            {\n                                \"tag_id\": \"paytag_2Ym84qFxvdh7m2tNvVIKPps0B03\",\n                                \"resource_type\": \"payments.payment_method.id\",\n                                \"resource_id\": \"41a64965-f990-4323-8781-ec56c5e365fc\",\n                                \"account_id\": \"acct_2Ym84qq2ieeaZkOHUM1xeF8uJtu\",\n                                \"namespace\": \"payment_method\",\n                                \"tag\": \"standard\",\n                                \"status\": \"ACTIVE\",\n                                \"integrator\": \"tilia-test\",\n                                \"created\": \"2023-11-27T21:06:45.950864Z\",\n                                \"updated\": \"2023-11-27T21:06:45.950864Z\"\n                            }\n                        ],\n                        \"wallet_balance\": \"10302750\",\n                        \"payment_method_id\": \"\",\n                        \"provider_data\": {\n                            \"balance\": 10302750,\n                            \"wallet_balance\": \"10302750\",\n                            \"wallet_id\": \"6e4dc9f9-b3d7-4752-866e-367d9c67b56b\"\n                        }\n                    },\n                    \"invoice_id\": \"d6627cf1-32eb-4695-8bef-b748e34758fa\",\n                    \"payment_id\": \"\",\n                    \"currency\": \"TIL\",\n                    \"display_amount\": \"TIL 350000\",\n                    \"display_string\": \"Standard TIL wallet\",\n                    \"requested_amount\": 350000,\n                    \"authorized_amount\": 350000,\n                    \"authorized_amount_usd\": 3500,\n                    \"provider\": \"wallet\",\n                    \"exchange_id\": \"\",\n                    \"tags\": {\n                        \"standard\": {\n                            \"tag_id\": \"\",\n                            \"tag\": \"\"\n                        }\n                    },\n                    \"created\": \"2023-12-08T23:14:17Z\",\n                    \"updated\": \"2023-12-08T23:14:17Z\",\n                    \"subitems\": {\n                        \"12c1c11b-4e8b-4cdc-8447-b59e02bc0f65\": {\n                            \"subitem_id\": \"12c1c11b-4e8b-4cdc-8447-b59e02bc0f65\",\n                            \"invoice_id\": \"d6627cf1-32eb-4695-8bef-b748e34758fa\",\n                            \"amount\": 0,\n                            \"amount_usd\": 0,\n                            \"currency\": \"TIL\",\n                            \"display_amount\": \"TIL 0\",\n                            \"invoice_reference\": \"pm_41a64965-f990-4323-8781-ec56c5e365fc\",\n                            \"reference_type\": \"\",\n                            \"reference_id\": \"\",\n                            \"subitem_type\": \"standard_virtual_payment\",\n                            \"source_account_id\": \"acct_2Ym84qq2ieeaZkOHUM1xeF8uJtu\",\n                            \"source_payment_method_id\": \"41a64965-f990-4323-8781-ec56c5e365fc\",\n                            \"source_wallet_id\": \"6e4dc9f9-b3d7-4752-866e-367d9c67b56b\",\n                            \"destination_account_id\": \"75452177-cad5-42bd-8530-4fb86ecc6fa9\",\n                            \"destination_payment_method_id\": \"\",\n                            \"destination_wallet_id\": \"87a494bc-f648-4dcd-b0fc-e59106e0598f\",\n                            \"description\": \"\",\n                            \"metadata\": {\n                                \"escrow\": true,\n                                \"pm_display_string\": \"Standard TIL wallet\"\n                            },\n                            \"exchange_id\": \"\",\n                            \"tags\": null,\n                            \"created\": \"2023-12-08T23:14:17Z\",\n                            \"updated\": \"2023-12-08T23:14:17Z\"\n                        }\n                    }\n                }\n            },\n            \"line_items\": {\n                \"1f4233ef-c570-41f0-b934-cb251b899182\": {\n                    \"line_item_id\": \"1f4233ef-c570-41f0-b934-cb251b899182\",\n                    \"invoice_id\": \"d6627cf1-32eb-4695-8bef-b748e34758fa\",\n                    \"amount\": 350000,\n                    \"amount_usd\": 3500,\n                    \"amount_refunded\": 0,\n                    \"currency\": \"TIL\",\n                    \"display_amount\": \"TIL 350000\",\n                    \"reference_type\": \"\",\n                    \"reference_id\": \"\",\n                    \"transaction_type\": \"user_to_user_escrow_virtual\",\n                    \"product_sku\": \"\",\n                    \"product_code\": \"\",\n                    \"description\": \"In-game digital bundle w/escrow\",\n                    \"exchange_id\": \"\",\n                    \"sort_order\": 0,\n                    \"tags\": null,\n                    \"created\": \"2023-12-08T23:14:17Z\",\n                    \"updated\": \"2023-12-08T23:14:17Z\",\n                    \"subitems\": {\n                        \"2d225e55-39df-4adc-a251-1e9288a03e68\": {\n                            \"subitem_id\": \"2d225e55-39df-4adc-a251-1e9288a03e68\",\n                            \"invoice_id\": \"d6627cf1-32eb-4695-8bef-b748e34758fa\",\n                            \"amount\": 350000,\n                            \"amount_usd\": 3500,\n                            \"currency\": \"TIL\",\n                            \"display_amount\": \"TIL 350000\",\n                            \"invoice_reference\": \"li_1f4233ef-c570-41f0-b934-cb251b899182\",\n                            \"reference_type\": \"invoicing.invoice_line_item_v2.line_item_id\",\n                            \"reference_id\": \"1f4233ef-c570-41f0-b934-cb251b899182\",\n                            \"subitem_type\": \"user_recipient_escrow_virtual\",\n                            \"source_account_id\": \"75452177-cad5-42bd-8530-4fb86ecc6fa9\",\n                            \"source_payment_method_id\": \"\",\n                            \"source_wallet_id\": \"41f5e46b-76ef-4bf8-b661-d5fb30159713\",\n                            \"source_wallet\": {\n                                \"wallet_id\": \"41f5e46b-76ef-4bf8-b661-d5fb30159713\",\n                                \"description\": \"tilia-test virtual asset TIL wallet\",\n                                \"account_id\": \"75452177-cad5-42bd-8530-4fb86ecc6fa9\",\n                                \"currency\": \"TIL\",\n                                \"current_balance\": 1764950,\n                                \"active\": true,\n                                \"tags\": [\n                                    \"hos\",\n                                    \"virtual_asset\",\n                                    \"virtual\",\n                                    \"negative_balance_allowed\"\n                                ],\n                                \"integrator\": \"tilia-test\",\n                                \"created\": \"2021-12-10T20:39:26.106346Z\",\n                                \"updated\": \"2023-12-08T21:45:53.934739Z\"\n                            },\n                            \"destination_account_id\": \"75452177-cad5-42bd-8530-4fb86ecc6fa9\",\n                            \"destination_payment_method_id\": \"\",\n                            \"destination_wallet_id\": \"5dac78d0-4864-4c2c-b3c2-9e2d1d3278af\",\n                            \"destination_wallet\": {\n                                \"wallet_id\": \"5dac78d0-4864-4c2c-b3c2-9e2d1d3278af\",\n                                \"description\": \"tilia-test virtual escrow TIL wallet\",\n                                \"account_id\": \"75452177-cad5-42bd-8530-4fb86ecc6fa9\",\n                                \"currency\": \"TIL\",\n                                \"current_balance\": 0,\n                                \"active\": true,\n                                \"tags\": [\n                                    \"hos\",\n                                    \"virtual_escrow\",\n                                    \"virtual\"\n                                ],\n                                \"integrator\": \"tilia-test\",\n                                \"created\": \"2021-12-10T20:39:26.106346Z\",\n                                \"updated\": \"2023-12-04T19:04:23.292372Z\"\n                            },\n                            \"description\": \"\",\n                            \"metadata\": {\n                                \"destination_account_id\": \"acct_2Ym85jZvz2HNx9q2LuouUymkFz3\",\n                                \"destination_wallet_id\": \"36dfbb98-2551-40c8-a60c-617e29bdbb48\",\n                                \"escrow\": true\n                            },\n                            \"exchange_id\": \"\",\n                            \"tags\": null,\n                            \"created\": \"2023-12-08T23:14:17Z\",\n                            \"updated\": \"2023-12-08T23:14:17Z\"\n                        },\n                        \"ff311897-2985-4e11-97ed-ceac95cb91ef\": {\n                            \"subitem_id\": \"ff311897-2985-4e11-97ed-ceac95cb91ef\",\n                            \"invoice_id\": \"d6627cf1-32eb-4695-8bef-b748e34758fa\",\n                            \"amount\": 350000,\n                            \"amount_usd\": 3500,\n                            \"currency\": \"TIL\",\n                            \"display_amount\": \"TIL 350000\",\n                            \"invoice_reference\": \"li_1f4233ef-c570-41f0-b934-cb251b899182\",\n                            \"reference_type\": \"invoicing.invoice_line_item_v2.line_item_id\",\n                            \"reference_id\": \"1f4233ef-c570-41f0-b934-cb251b899182\",\n                            \"subitem_type\": \"ar_to_asset\",\n                            \"source_account_id\": \"75452177-cad5-42bd-8530-4fb86ecc6fa9\",\n                            \"source_payment_method_id\": \"\",\n                            \"source_wallet_id\": \"87a494bc-f648-4dcd-b0fc-e59106e0598f\",\n                            \"source_wallet\": {\n                                \"wallet_id\": \"87a494bc-f648-4dcd-b0fc-e59106e0598f\",\n                                \"description\": \"tilia-test virtual ar TIL wallet\",\n                                \"account_id\": \"75452177-cad5-42bd-8530-4fb86ecc6fa9\",\n                                \"currency\": \"TIL\",\n                                \"current_balance\": 0,\n                                \"active\": true,\n                                \"tags\": [\n                                    \"hos\",\n                                    \"virtual_ar\",\n                                    \"negative_balance_allowed\",\n                                    \"virtual\"\n                                ],\n                                \"integrator\": \"tilia-test\",\n                                \"created\": \"2021-12-10T20:39:26.106346Z\",\n                                \"updated\": \"2023-12-08T21:45:53.934739Z\"\n                            },\n                            \"destination_account_id\": \"75452177-cad5-42bd-8530-4fb86ecc6fa9\",\n                            \"destination_payment_method_id\": \"\",\n                            \"destination_wallet_id\": \"41f5e46b-76ef-4bf8-b661-d5fb30159713\",\n                            \"destination_wallet\": {\n                                \"wallet_id\": \"41f5e46b-76ef-4bf8-b661-d5fb30159713\",\n                                \"description\": \"tilia-test virtual asset TIL wallet\",\n                                \"account_id\": \"75452177-cad5-42bd-8530-4fb86ecc6fa9\",\n                                \"currency\": \"TIL\",\n                                \"current_balance\": 1764950,\n                                \"active\": true,\n                                \"tags\": [\n                                    \"hos\",\n                                    \"virtual_asset\",\n                                    \"virtual\",\n                                    \"negative_balance_allowed\"\n                                ],\n                                \"integrator\": \"tilia-test\",\n                                \"created\": \"2021-12-10T20:39:26.106346Z\",\n                                \"updated\": \"2023-12-08T21:45:53.934739Z\"\n                            },\n                            \"description\": \"\",\n                            \"metadata\": null,\n                            \"exchange_id\": \"\",\n                            \"tags\": null,\n                            \"created\": \"2023-12-08T23:14:17Z\",\n                            \"updated\": \"2023-12-08T23:14:17Z\"\n                        }\n                    }\n                }\n            },\n            \"subitems\": {},\n            \"tags\": null,\n            \"summary\": {\n                \"total_amount\": 350000,\n                \"total_amount_usd\": 3500,\n                \"currency\": \"TIL\",\n                \"display_amount\": \"TIL 350000\",\n                \"subtotal\": {\n                    \"total_amount\": 350000,\n                    \"total_amount_usd\": 3500,\n                    \"currency\": \"TIL\",\n                    \"display_amount\": \"TIL 350000\"\n                },\n                \"tax\": {\n                    \"total_amount\": 0,\n                    \"total_amount_usd\": 0,\n                    \"currency\": \"TIL\",\n                    \"display_amount\": \"TIL 0.00\"\n                },\n                \"payment_breakdown\": [],\n                \"tax_calculation\": \"\"\n            }\n        }\n    }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After creating the transaction, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload.status"]}," value is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OPEN"]},"."," ","Notice that the invoice data returned in the response body includes many more properties"," ","than were sent in the request."," ","For more information about what you can include when creating an invoice, review"," ",{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/escrow-transaction/createescrowtransaction","text":"Create an escrow transaction"},"children":[]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pay-escrow-transaction","__idx":4},"children":["Pay escrow transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This exercise pays the transaction created in the previous request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The preceding task only created an invoice in Tilia's e-commerce system."," ","No tokens have changed accounts, yet."," ","This exercise collects the tokens from the payer and holds them in escrow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To pay the escrow transaction, in Postman:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collection, in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Escrow transaction - completed"]}," folder,"," ","open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pay escrow transaction"]}," request."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}," field, notice that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoice_id"]}," returned by the preceding request is used"," ","to identify the invoice to pay."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pay escrow transaction"]}," request, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the response returns, open the response ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}," tab below the request to review the response body details."]}]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Show a typical response body with the payment details."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"status\": \"Success\",\n    \"message\": [],\n    \"codes\": [],\n    \"payload\": {\n        \"id\": \"esc_2ZHRweUDyUY2PW2vCuKtSExL3uH\",\n        \"account_id\": \"acct_2Ym84qq2ieeaZkOHUM1xeF8uJtu\",\n        \"escrow_invoice_id\": \"d6627cf1-32eb-4695-8bef-b748e34758fa\",\n        \"commit_invoice_id\": \"\",\n        \"cancel_invoice_id\": \"\",\n        \"status\": \"ESCROWED\",\n        \"integrator\": \"tilia-test\",\n        \"created\": \"2023-12-08T23:14:17Z\",\n        \"updated\": \"2023-12-08T23:14:17Z\",\n        \"escrow_invoice\": {\n            \"invoice_id\": \"\",\n            \"integrator\": \"\",\n            \"account_id\": \"\",\n            \"invoice_type\": \"\",\n            \"reference_type\": \"\",\n            \"reference_id\": \"\",\n            \"transfer_id\": \"\",\n            \"session_id\": \"\",\n            \"state\": \"\",\n            \"description\": \"\",\n            \"failure_code\": \"\",\n            \"failure_reason\": \"\",\n            \"created\": \"\",\n            \"updated\": \"\",\n            \"payment_methods\": null,\n            \"line_items\": null,\n            \"subitems\": null,\n            \"tags\": null,\n            \"summary\": {\n                \"total_amount\": 0,\n                \"total_amount_usd\": 0,\n                \"currency\": \"\",\n                \"display_amount\": \"\",\n                \"subtotal\": {\n                    \"total_amount\": 0,\n                    \"total_amount_usd\": 0,\n                    \"currency\": \"\",\n                    \"display_amount\": \"\"\n                },\n                \"tax\": {\n                    \"total_amount\": 0,\n                    \"total_amount_usd\": 0,\n                    \"currency\": \"\",\n                    \"display_amount\": \"\"\n                },\n                \"payment_breakdown\": null,\n                \"tax_calculation\": \"\"\n            }\n        }\n    }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The invoice returned in the response buffer shows the current state of the invoice in the value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload.status"]},","," ","which is now ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ESCROWED"]},"."," ","The tokens from the payer have been collected and are being held in escrow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"commit-escrow-transaction","__idx":5},"children":["Commit escrow transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This exercise commits the escrow transaction and pays the recipient."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The preceding exercise collected tokens from the payer to hold them in escrow."," ","This exercise completes the purchase process and transfers the funds to the recipient,"," ","which you would do after the escrow conditions have been met."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To commit the escrow transaction, in Postman:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collection, in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Escrow transaction - completed"]}," folder,"," ","open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Commit escrow transaction"]}," request."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}," field, notice that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoice_id"]}," returned by the create request"," ","is used to identify the invoice to commit."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Commit escrow transaction"]}," request, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the response returns, open the response ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}," tab below the request to review the response body details."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A typical response body looks like the following."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"status\": \"Success\",\n    \"message\": [],\n    \"codes\": [],\n    \"payload\": {\n        \"id\": \"esc_2ZHRweUDyUY2PW2vCuKtSExL3uH\",\n        \"account_id\": \"acct_2Ym84qq2ieeaZkOHUM1xeF8uJtu\",\n        \"escrow_invoice_id\": \"d6627cf1-32eb-4695-8bef-b748e34758fa\",\n        \"commit_invoice_id\": \"323a3574-59d0-44ee-a1f2-084da8c75bf3\",\n        \"cancel_invoice_id\": \"\",\n        \"status\": \"COMMITTED\",\n        \"integrator\": \"tilia-test\",\n        \"created\": \"2023-12-08T23:14:17Z\",\n        \"updated\": \"2023-12-08T23:18:34Z\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload.status"]}," value is now ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COMMITTED"]}," showing that the payer has paid the invoice"," ","identified in the response buffer and the recipient has received the payment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancel-escrow-transaction","__idx":6},"children":["Cancel escrow transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This exercise demonstrates how to cancel an active, and paid, escrow transaction."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After an escrow transaction has been paid, it can be canceled instead of committed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The preceding exercises collected tokens from the payer to hold them in escrow until the escrow conditions have been met."," ","If the escrow conditions are not met, this cancels the purchase process, and returns the tokens to the payer."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-and-pay-an-escrow-transaction-to-cancel","__idx":7},"children":["Create and pay an escrow transaction to cancel"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before an escrow transaction can be canceled, it must be created and paid."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To create a new user-to-user escrow transaction, in Postman:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collection, in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Escrow transaction - canceled"]}," folder,"," ","open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a user-to-user escrow transaction"]}," request."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the request ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}," tab, notice that it has an object that is"," ","similar to that used in the previous exercises."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a user-to-user escrow transaction"]}," request, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the response returns successfully, continue."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collection, in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Escrow transaction - canceled"]}," folder,"," ","open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pay escrow transaction"]}," request."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pay escrow transaction"]}," request, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the response returns successfully, continue."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At this point, you have a paid escrow transaction that can be committed or canceled."," ","Continue to the next exercise to cancel it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cancel-the-paid-escrow-transaction","__idx":8},"children":["Cancel the paid escrow transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To cancel the escrow transaction, in Postman:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collection, in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Escrow transaction - canceled"]}," folder,"," ","open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cancel escrow transaction"]}," request."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}," field, notice that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoice_id"]}," returned by the preceding request"," ","is used to identify the invoice to pay."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cancel escrow transactio"]},"n request, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the response returns, open the response ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}," tab below the request to review the response body details."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A typical response body looks like the following."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"status\": \"Success\",\n    \"message\": [],\n    \"codes\": [],\n    \"payload\": {\n        \"id\": \"esc_2ZHVpXpoNaWxYmBLkk9aNUHgBNp\",\n        \"account_id\": \"acct_2Ym84qq2ieeaZkOHUM1xeF8uJtu\",\n        \"escrow_invoice_id\": \"7c93346a-7c02-4bc4-8270-1d461302603b\",\n        \"commit_invoice_id\": \"\",\n        \"cancel_invoice_id\": \"7b11217d-265c-4408-b6cb-32f24d3f3934\",\n        \"status\": \"CANCELLED\",\n        \"integrator\": \"tilia-test\",\n        \"created\": \"2023-12-08T23:46:14Z\",\n        \"updated\": \"2023-12-08T23:46:22Z\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload.status"]}," value is now ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCELLED"]}," showing that the invoice identified in"," ","the response buffer has been canceled and the tokens have been returned to the payer."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":9},"children":["Next steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The exercises in this tutorial used Postman to call the Tilia APIs."," ","For an example of how to integrate the escrow transaction demonstrated in this tutorial into a web page,"," ","see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/escrow-transaction"},"children":["Escrow transaction"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're curious, you can review the wallet balances of the users involved in this transaction by using the exercises in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions/tutorial_txn_info"},"children":["Get info about transactions"]}," tutorial."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also return to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions"},"children":["Transaction tutorials overview"]}," and find another transaction tutorial, or just go to the next transaction tutorial."]}]},"headings":[{"value":"Tutorial: Make escrow transactions","id":"tutorial-make-escrow-transactions","depth":1},{"value":"API operations in this tutorial","id":"api-operations-in-this-tutorial","depth":3},{"value":"To complete this tutorial","id":"to-complete-this-tutorial","depth":2},{"value":"Create a user-to-user escrow invoice","id":"create-a-user-to-user-escrow-invoice","depth":2},{"value":"Pay escrow transaction","id":"pay-escrow-transaction","depth":2},{"value":"Commit escrow transaction","id":"commit-escrow-transaction","depth":2},{"value":"Cancel escrow transaction","id":"cancel-escrow-transaction","depth":2},{"value":"Create and pay an escrow transaction to cancel","id":"create-and-pay-an-escrow-transaction-to-cancel","depth":3},{"value":"Cancel the paid escrow transaction","id":"cancel-the-paid-escrow-transaction","depth":3},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Tutorial: Make escrow transactions"}},"lastModified":"2026-02-05T18:12:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/tutorials/transactions/tutorial_txn_escrow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}