> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slm.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Working with Tokens

A `Token` object represents a metering or virtual-currency unit of a specific type, and may be used to support billing models that use arbitrary tracking units with tokens and related objects in the Subscribe API. The units are of your own choosing and may be minutes, downloads, incentive points, virtual currency, storage space, number of users, or any other imaginable unit. In the Subscribe API, those units are represented by a generic `Token` object. Tokens allow you to define token `types`, and associate them with a customer Account. Tokens may be purchased, granted, decremented, or refunded, and you may retrieve Token balances for customer Accounts.

**Note:** Use of the forward slash character (/) in merchant identifiers is not allowed. See [Merchant Identifiers](Merchant_Identifiers#) for more information.

The following table describes the three token-related objects.

| Subscribe Object | Description |
| - | - |
| Token | Defines a token of a certain type. It must have a unique ID. |
| TokenAmount | The number of tokens, of a certain type, used to define a Billing Plan or product price in terms of tokens. |
| TokenTransaction | A purchase made with tokens. `TokenTransaction` contains attributes that specify the customer account that made the purchase, the amount, and the token type. `TokenTransaction` also includes a timestamp that shows when the transaction occurred. The purchase is a lightweight transaction that can be conducted in lieu of standard Subscribe transaction. |

You may define any number of Tokens, and can manage each customer’s associated balance of units by granting (incrementing), and decrementing Token counts through Products, Billing Plans, or AutoBills.

Token Transactions pass through the Subscribe Token Processor, and appear as Transactions in all applicable Subscribe Portal pages, including generated Reports.

* **[Understanding Subscribe Token Objects](../topics/Understanding_Subscribe_)**

* **[Understanding Token Activities](../topics/Understanding_Token_Acti)**

* **[Defining New Token Types](../topics/Defining_New_Token_Types)**

* **[Incrementing Token Balances](../topics/Incrementing_Token_Balan)**

* **[Decrementing Token Balances](../topics/Decrementing_Token_Balan)**

* **[Handling Recurring Billing with Tokens](../topics/Handling_Recurring_Billi)**

* **[Refunding Transactions in Tokens](../topics/Refunding_Transactions_i)**

* **[The Subscribe Token Processor](../topics/The_Subscribe_Token_Proc)**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.