Wallets and Payment Methods

Tilia services use wallets and payment methods to provide the funds used in Tilia transactions.

Wallet resources

Wallets, or wallet resources, determine the amount of a given currency that belongs to a user account.

Wallets created with the user account to which they belong

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.

Multiple wallets per user, one user per wallet

While a user account can have multiple wallets, each wallet can belong to one and only one user account.

Token wallets

Each account has two token wallets by default.

  • 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.
  • 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.

See also, Virtual tokens.

Publishers have wallets, too

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.

One currency per wallet

Each wallet is associated with exactly one currency. The wallet's currency can be represented by an ISO 4217 currency type or by a code for your virtual tokens.

Wallet balances

Each wallet starts with a balance of 0.

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.

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 100. For more information about wallet currencies, visit Working with currencies.

Funds can be added to the wallet by using Tilia transactions, such as user-to-user purchases or token purchases.

The current balance of a user's wallet can be retrieved by using the Tilia API, Get wallet balances.

Payment methods

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.

Tilia services accept these credit cards as payment methods:

  • American Express
  • China UnionPay
  • Diners Club
  • Discover
  • IBAN
  • JCB
  • MasterCard
  • Visa

Examples and tutorials

For examples of interactions that use payment methods, wallets, and wallet balances, visit our Tutorials.