{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["openapiLink"]},"type":"markdown"},"seo":{"title":"Use-case tutorial: Marketplace","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":"use-case-tutorial-marketplace","__idx":0},"children":["Use-case tutorial: Marketplace"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this tutorial, you demonstrate the interactions that are common in a Marketplace."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Allow about 30 minutes to complete this tutorial."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows the interactions that are often found in a digital"," ","marketplace and demonstrated in this tutorial."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/use-case-tutorial-marketplace.fe7d0d637ac2943659c57534d1bb54a0027b177e3eca7fc86d1319186a4d681f.9c1bb791.png","alt":"Diagram of marketplace interactions"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To demonstrate common Marketplace interactions, the exercises in this tutorial:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add new users: a payer, a recipient, and a creator"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Show the payer buying tokens to use in the marketplace"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Show the payer using tokens to buy digital goods from the recipient"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Show the recipient receive fiat currency for their earned tokens"]}]},{"$$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":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts/tutorial_user_new_users#create-new-users"},"children":["Create new users"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"accounts/openapi/other/registeraccounthandlerfor","text":"Register account"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts/tutorial_user_buy_tokens#add-a-payment-method-ui"},"children":["Add a payment method (UI)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Add Payment Method widget"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts/tutorial_user_buy_tokens#get-payers-payment-methods"},"children":["Get payer's payment methods"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"payments/openapi/other/getpaymentmethods","text":"Get payment methods"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts/tutorial_user_buy_tokens#start-token-purchase"},"children":["Start token purchase"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/virtual-tokens/createtokenpurchase","text":"Initiate token purchase"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts/tutorial_user_buy_tokens#finish-token-purchase"},"children":["Finish token purchase"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/virtual-tokens/executetokenpurchase","text":"Execute token purchase"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts/tutorial_user_wallets#get-wallet-info"},"children":["Get wallet info"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"wallets/openapi/other/getwalletsbyaccountid","text":"Get wallets by account"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts/tutorial_user_wallets#view-wallet-balances"},"children":["View wallet balances"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"wallets/openapi/other/getbalancesbyaccountid","text":"Get wallet balances"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts/tutorial_user_tos_kyc#check-payers-tos-status"},"children":["Check payer's TOS status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"accounts/openapi/other/vlatestgettiliatos","text":"Check for Terms of Service"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts/tutorial_user_tos_kyc#check-users-kyc-status"},"children":["Check user's KYC status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"pii/openapi/other/getkycstatus","text":"Check KYC status"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions/tutorial_txn_standard"},"children":["Create a user-to-user invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/invoice/createinvoice","text":"Create a new invoice"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions/tutorial_txn_standard"},"children":["Pay a user-to-user-invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/invoice/payinvoice","text":"Pay invoice"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions/tutorial_txn_payout"},"children":["Payout tokens as fiat currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payout UI widget"]}]}]}]}]},{"$$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 requests from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["_Manage user accounts"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collections from the"," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.postman.com/tilia-docs-testing/workspace/get-started-using-tilia-services/overview"},"children":["shared 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":["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":["Manage user accounts"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore Tilia transactions"]}," collections"," ","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 your Tilia developer credentials."]}]},{"$$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":"Heading","attributes":{"level":2,"id":"add-new-users-to-the-marketplace","__idx":3},"children":["Add new users to the marketplace"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts"},"children":["User account tutorials"]}," demonstrate these tasks"," ","that add new users to your marketplace and prepare them to make transactions:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add new users to a marketplace."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add a payment method to the payer so they can buy tokens."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Buy tokens so the payer can purchase digital goods."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["View the users' wallets and their current balances."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure that the users have accepted Tilia's Terms Of Service"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure that the recipient has provided the necessary tax information to be able to accept payout."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To run these tasks, in another window, open the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts"},"children":["User account tutorials"]}," ","and follow the tasks to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create new users"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After you complete the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User account tutorials"]},", return to this topic and continue to the next section."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"buy-digital-goods-from-another-user","__idx":4},"children":["Buy digital goods from another user"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this exercise, the payer uses some of the tokens they just purchased from the publisher"," ","to buy an ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["In-game digital bundle"]}," from another user."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section includes these interactions:"]},{"$$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":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Create a user-to-user invoice"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/invoice/createinvoice","text":"Create a new invoice"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Pay a user-to-user-invoice"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi/invoice/payinvoice","text":"Pay invoice"},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create and pay for the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["In-game digital bundle"]},","," ","in another window, open ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions/tutorial_txn_standard"},"children":["Make standard transactions"]}," ","and complete the tutorial."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After you complete the transaction in that tutorial, return to this topic to continue"," ","exploring other marketplace interactions."]},{"$$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 before continuing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payout-to-user","__idx":5},"children":["Payout to user"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This exercise pays a token balance it its corresponding fiat currency value and"," ","deposits the fiat currency value to the user's payment method, such as PayPal."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After a seller (recipient) has earned enough tokens, they can collect the token value"," ","as fiat currency."," ","Generally, the seller should have convertible tokens worth USD $5.00 or more before"," ","they initiate a payout."," ","If the recipient doesn't have enough tokens for a payout, repeat the"," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions/tutorial_txn_standard"},"children":["Make standard transactions"]}," tutorial several times to increase"," ","their token balance."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To pay the recipient in fiat currency for the convertible tokens they have collected from"," ","sales, complete the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions/tutorial_txn_payout"},"children":["Payout to a user"]}," tutorial."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"conclusion","__idx":6},"children":["Conclusion"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The exercises in this tutorial walked you through the interactions that are"," ","common in a marketplace."," ","You can build your marketplace on these Tilia services to"," ","get started."," ","You can also enhance the marketplace experience by adding these features:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/use-cases/tutorial_use_case_royalties"},"children":["Royalties"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#"},"children":["Commissions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/use-cases/tutorial_use_case_reward"},"children":["User rewards"]}]}]}]},"headings":[{"value":"Use-case tutorial: Marketplace","id":"use-case-tutorial-marketplace","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":"Add new users to the marketplace","id":"add-new-users-to-the-marketplace","depth":2},{"value":"Buy digital goods from another user","id":"buy-digital-goods-from-another-user","depth":2},{"value":"Payout to user","id":"payout-to-user","depth":2},{"value":"Conclusion","id":"conclusion","depth":2}],"frontmatter":{"seo":{"title":"Use-case tutorial: Marketplace"}},"lastModified":"2026-02-05T18:12:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/tutorials/use-cases/tutorial_use_case_market","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}