{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Transaction History Flow","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":"transaction-history-flow","__idx":0},"children":["Transaction History Flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transaction History flow enables a user to view a complete, chronological list of all transactions that have occurred during the lifetime of the account:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Purchases for digital goods or services"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Token purchases"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Token conversions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payouts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refunds"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a user opens this page, several of their most recent transactions are displayed. They can filter their list to view either pending or completed transactions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/txnhistory.cc00f8c92f207c2d86306d72ea1ac67113839de51ff9bc8a563de40c38a6f033.9c1bb791.png","alt":"Transaction History Example"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a user clicks or taps on a specific transaction, a transaction details page appears. On this page, users can view the details of a specific transaction and request a receipt of that transaction be sent to them."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Buyers and sellers participating in the same transaction see different details:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A buyer receipt includes line items for all items that have been purchased by the specific buyer. Purchases from one or multiple sellers can appear on the buyer receipt."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A seller receipt includes line items for all items that have been sold to a buyer. Only items sold by the seller to the specific buyer appear on the seller receipt."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This flow begins with a check for a signed TOS. If one has not been signed, a TOS screen appears for a user to accept before proceeding with the flow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$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":"Requirement"},"children":["Requirement"]},{"$$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":["ID of the < div > element"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Publisher-defined, named < div > in which the Transaction History flow will be rendered"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/web-uis/widget-overview/#step-3-retrieve-redirect-url-and-execute-the-flow"},"children":["Redirect URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL that initiates the flow. The user requesting to view the transaction history must be part of the transactions being retrieved."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-flowconfig-options","__idx":2},"children":["Supported flowConfig Options"]},{"$$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":"Keys (all optional)"},"children":["Keys (all optional)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Values"},"children":["Values"]},{"$$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":["hideExitButtons"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean (default: false)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hides 'X' button where user can close out the UI."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["hideMergedAccountSelector"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean (default: false)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hides the section of the UI that displays the username and the merged account selector (when applicable)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["txnHistoryTabIndex"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 or 1 (integer, defaults to 0 which is 'Completed')"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Selects which tab ('Completed' or 'Pending') the UI defaults to showing.  Use 1 to default to 'Pending'."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["disableTxnHistoryUserFiltering"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean (default: false)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disables ability for user to change (or view) filter settings."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["txnHistoryFiltersStr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["comma separated string (options are: \"purchase\", \"sale\", \"token_purchase\", \"token_convert\", \"payout\", \"refund\", \"deposit\", \"balance_transfer\")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Allows setting a default search filter."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"widget-flow-implementation","__idx":3},"children":["Widget Flow Implementation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following steps to open and customize a transaction history flow in the widget:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the following code sample"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"window.Tilia.execute({\n        rootId: \"<YOUR-ELEMENT-ID>\"\n        flow: \"txnhistory\",\n        redirect: \"<WIDGET-REDIRECT-URL>\",\n        onComplete: handleComplete,\n        onError: handleError,\n        theme: {\n            backgroundColor: \"#323232\",\n            primaryColor: \"#47CC00\"\n        },\n        flowConfig: {} // see supported flowConfig options above\n});\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Replace the placeholder values (< YOUR-ELEMENT-ID > and < WIDGET-REDIRECT-URL >) with the values from the Requirements section"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#supported-flowconfig-options"},"children":["Customize the flowConfig"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) In the theme object, ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/web-uis/customization"},"children":["customize the appearance"]}," of the widget"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"events","__idx":4},"children":["Events"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transaction History flow fires the following events."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"oncomplete","__idx":5},"children":["OnComplete"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fired when a user clicks the Close button"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n    event: \"tilia.txnhistory.complete\",\n    flow: \"txnhistory\",\n    source: \"tilia\"\n}\n","lang":"javascript"},"children":[]}]},"headings":[{"value":"Transaction History Flow","id":"transaction-history-flow","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Supported flowConfig Options","id":"supported-flowconfig-options","depth":2},{"value":"Widget Flow Implementation","id":"widget-flow-implementation","depth":2},{"value":"Events","id":"events","depth":2},{"value":"OnComplete","id":"oncomplete","depth":3}],"frontmatter":{"seo":{"title":"Transaction History Flow"}},"lastModified":"2026-02-05T18:12:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/web-uis/transaction-history","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}