{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["openapiLink"]},"type":"markdown"},"seo":{"title":"Wallets and Payment Methods","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":"wallets-and-payment-methods","__idx":0},"children":["Wallets and Payment Methods"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tilia services use wallets and payment methods to provide the funds used in Tilia transactions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"wallet-resources","__idx":1},"children":["Wallet resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wallets"]},", or wallet resources, determine the amount of a given currency that belongs to a user account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"wallets-created-with-the-user-account-to-which-they-belong","__idx":2},"children":["Wallets created with the user account to which they belong"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wallets are automatically created when an end user is registered and their user account in Tilia is created."," ","Tilia configures the wallet currency and the number of wallets that are created for a user account"," ","to meet your application's requirements."," ","Each wallet is assigned a unique identifier that is used in invoices and payouts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"multiple-wallets-per-user-one-user-per-wallet","__idx":3},"children":["Multiple wallets per user, one user per wallet"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While a user account can have multiple wallets, each wallet can belong to one and only one user account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"token-wallets","__idx":4},"children":["Token wallets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each account has two token wallets by default."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standard token wallets"]}," hold tokens that can only be used inside the application."," ","When a user buys tokens with an external payment method, they are added to their standard token wallet."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Convertible token wallets"]}," hold tokens that can be exchanged for fiat currency"," ","and their value can be taken out of the application."," ","When a user earns tokens as the recipient in a transaction, those tokens are added"," ","to their convertible token wallet."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See also, ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/core-concepts/virtual-tokens"},"children":["Virtual tokens"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"publishers-have-wallets-too","__idx":5},"children":["Publishers have wallets, too"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to the end-user wallets, there are special publisher wallets that are associated with your organization."," ","These wallets are used when moving funds around in the process of conducting Tilia transactions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"one-currency-per-wallet","__idx":6},"children":["One currency per wallet"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each wallet is associated with exactly one currency."," ","The wallet's currency can be represented by an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":["ISO 4217 currency type"]}," ","or by a code for your virtual tokens."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"wallet-balances","__idx":7},"children":["Wallet balances"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each wallet starts with a balance of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A wallet balance can be used as a payment method for Tilia purchases or transferred to the user as a payout,"," ","if your business rules allow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wallets maintain a balance amount, which is expressed in the lowest denomination of the wallet's currency."," ","For example, a wallet that uses USD as the currency would express values in cents (1/100 USD)."," ","So, a value of USD $1.00 would be stored in its wallet as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["100"]},"."," ","For more information about wallet currencies, visit ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/core-concepts/working-with-currencies"},"children":["Working with currencies"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Funds can be added to the wallet by using Tilia transactions, such as user-to-user purchases or token purchases."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The current balance of a user's wallet can be retrieved by using the Tilia API,"," ",{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"wallets/openapi/other/getbalancesbyaccountid","text":"Get wallet balances"},"children":[]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-methods","__idx":8},"children":["Payment methods"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment Methods"]}," are the payment instruments that are supported to conduct Tilia transactions in your application."," ","Payment methods can be credit cards, PayPal accounts, or Tilia wallet balances."," ","Some payment methods can be stored for future use or added for one-time transactions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tilia services accept these credit cards as payment methods:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["American Express"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["China UnionPay"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Diners Club"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Discover"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["IBAN"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["JCB"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["MasterCard"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Visa"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples-and-tutorials","__idx":9},"children":["Examples and tutorials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For examples of interactions that use payment methods, wallets, and wallet balances,"," ","visit our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials"},"children":["Tutorials"]},"."]}]},"headings":[{"value":"Wallets and Payment Methods","id":"wallets-and-payment-methods","depth":1},{"value":"Wallet resources","id":"wallet-resources","depth":2},{"value":"Wallets created with the user account to which they belong","id":"wallets-created-with-the-user-account-to-which-they-belong","depth":3},{"value":"Multiple wallets per user, one user per wallet","id":"multiple-wallets-per-user-one-user-per-wallet","depth":3},{"value":"Token wallets","id":"token-wallets","depth":4},{"value":"Publishers have wallets, too","id":"publishers-have-wallets-too","depth":3},{"value":"One currency per wallet","id":"one-currency-per-wallet","depth":3},{"value":"Wallet balances","id":"wallet-balances","depth":3},{"value":"Payment methods","id":"payment-methods","depth":2},{"value":"Examples and tutorials","id":"examples-and-tutorials","depth":2}],"frontmatter":{"seo":{"title":"Wallets and Payment Methods"}},"lastModified":"2026-02-05T18:12:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/core-concepts/wallets","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}