{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Core Concepts","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":"core-concepts","__idx":0},"children":["Core Concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide describes the core concepts and resources used to structure Tilia API data."," ","Understanding these core concepts and resources will make it easier to work with our resources"," ","and build integrations with the Tilia APIs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-resources","__idx":1},"children":["Core resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The core resources of Tilia services are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User accounts"]},", which comprises:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/account-resources.b671a7693e02feebc8e0829cccc9a145c455f916b4edf4c2f2ceb0615bc13bac.9c1bb791.png","alt":"Tilia account resources"},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/core-concepts/accounts"},"children":["Account"]}," - Account resources represent end-users who wants to perform transactions"," ","such as buying or selling digital goods. Accounts include ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wallets"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment methods"]},"."," ","User accounts also collect ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PII"]}," (personally identifiable information)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PII"]}," - PII resources and processes verify user identity"," ","and keep track of a user's personal jurisdictional information"," ","to use in the calculation of local taxes and compliance."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/core-concepts/wallets"},"children":["Wallet"]}," - Wallet resources represent the current amount of a specific type of currency or token."," ","Each Account includes one or more ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wallets"]},"."," ","Head of State (HoS) wallets are special wallets that are associated with your organization"," ","and not linked to payment methods."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/core-concepts/wallets"},"children":["Payment Method"]}," - Payment method resources are sources of funds that"," ","users can use in transactions."," ","Payment method resources can represent external payment cards and bank accounts, as well as the wallets of a user's account."]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions"]},", which comprises:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/transaction-resources.040583e08385bd6b8ef1da69e8ecb45d7b6e21e842a4c6272362d3faf25e6885.9c1bb791.png","alt":"Tilia transactiond details"},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/core-concepts/invoicing"},"children":["Invoices"]}," - Describes the details of all purchase transactions within Tilia."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/core-concepts/payouts"},"children":["Payouts"]}," - Transfers funds from a user's Tilia wallet to an external account."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The topics in this section go into more detail about each of these core resources."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For examples of these core resources in use, visit our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials"},"children":["Tutorials"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-the-core-resources-work-in-a-digital-marketplace","__idx":2},"children":["How the core resources work in a digital marketplace"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section demonstrates one example of how the core resources of Tilia's services work together."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In a digital marketplace, the users, that is the buyers and sellers, are represented by their user accounts."," ","Users use payment methods to purchase tokens for their wallets."," ","Users use wallets to manage the funds they hold in the application."," ","The exchanges that users make in the application are described by invoices, much like"," ","exchanges in the real world."," ","Users can receive the real-world value of their earned tokens in a payout, after providing"," ","the personally-identifiable information (PII) required by their jurisdiction."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows how these interactions can take place in a digital marketplace"," ","that's powered by Tilia services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/core-concepts-marketplace.b43b8fc6f980a04baf9f9c279691b246f828e2aea8560fdd6392abe644c88ca6.9c1bb791.png","alt":"Diagram of marketplace interactions"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The digital marketplace is just one of many digital economies that Tilia services can support."," ","For more examples, visit our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/use-cases"},"children":["Use-case examples"]},"."]}]},"headings":[{"value":"Core Concepts","id":"core-concepts","depth":1},{"value":"Core resources","id":"core-resources","depth":2},{"value":"How the core resources work in a digital marketplace","id":"how-the-core-resources-work-in-a-digital-marketplace","depth":2}],"frontmatter":{"enableToc":false,"seo":{"title":"Core Concepts"}},"lastModified":"2024-02-21T23:43:58.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/core-concepts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}