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

# Understanding Token Activities

View token activities on the Subscribe Portal by selecting **Search** > **Token Activity** from the menu bar, then specifying your company name. The four token activity types are:

* **Decrement**: When a customer accesses a service (downloads music or uses storage), make an API call to deduct the appropriate number of tokens.
* **Grant**: Grant tokens to a customer by making an API call or by performing a customer-service action of Grant Tokens on the Subscribe Portal.
* **Purchase**: A one-time or recurring transaction that references a product with tokens granted, or a transaction whose payment method is tokens.
* **Refund**: Refund a purchase that was transacted in tokens or that was for a product that had tokens granted.

| Activity Type | Example | Description | Results | Token Balance |
| - | - | - | - | - |
| Decrement | The customer accesses a service, and the merchant reduces the customer’s token balance. | Call the API’s `decrementTokens` method on the customer account. | - Updated token activity on customer’s **Account Details** page. - Updated token balance for the related payment method. - Details on the **Token Activity Results** page. | Decremented |
| Grant | Add tokens to a customer’s account for filling out a survey. | Call the API’s `incrementTokens` method on the customer account. | - Updated token activity on customer’s **Account Details**page. - New token payment methods, if they do not already exist. - Details on the **Token Activity Results** Notification email to the customer on the tokens granted. - page. | Incremented |
| Grant | Add tokens to a customer’s account to compensate for degraded service. | Grant tokens on the Subscribe Portal. | - Notification email to the customer on the tokens granted. - New token payment methods, if they do not already exist. - Increased token balance. - Updated token activity on the customer’s **Account Details** page. - Updated token balance for the related payment method. - Details on the **Token Activity Results** page. | Incremented |
| Purchase | A customer makes a purchase that adds token types to the customer’s account balance. The transaction is successfully captured. | Grant tokens to a one-time purchase. | - Notification email to the customer on the token activity and account balance. - New token payment methods, if they do not already exist. - Increased token-type balance. - Display of line items associated with each token type in the **Token Activity** table on the **Transaction Details** page. - Updated token activity on the customer’s **Account Details**page. - Updated token balance for the related payment method. - Details on the **Token Activity Results** page. - Reference of the transaction ID by the activity. | Incremented |
| Purchase | A customer has an AutoBill subscription for a product that adds multiple token types to the customer’s account balance. The transaction is successfully captured. | Grant tokens to an AutoBill subscription with a product that has associated tokens granted. | Same as above. | Decremented |
| Purchase | A customer makes a purchase for which you accept tokens as the payment method. Afterwards, you submit a transaction to Subscribe and reference the token type. | Transact a one-time purchase in tokens. | - Notification to the customer: Real-Time Statement of Success or Real-Time Statement of Failure. - Reduced token-type balance. - Inclusion of the line items associated with the token type in the transaction. - Updated token activity on the customer’s **Account Details** page. - Updated token balance for the related payment method. - Details on the **Token Activity Results** page. | Decremented |
| Purchase | A customer has an AutoBill subscription for a product associated with a billing plan that is transacted in tokens. There are enough tokens in the related account to cover the cycle cost. | Transact an AutoBill subscription with a billing-period cycle in tokens. | - Prebilling notification to the customer. - A success notification to the customer if there are enough tokens in the account. Otherwise, the notification states that not enough tokens are available. - Reduced token-type balance. - Inclusion of the line items associated with the token type in the transaction. - Updated token balance for the related payment method. - Details on the **Token Activity Results** page. - Updated token activity on the customer’s **Account Details** page. | Decremented |
| Refund | A customer makes a purchase with tokens and then requests a refund. (Subscribe only supports *full* refunds for token transactions.) | Refund a real-time transaction that was paid for in tokens. | - Refund notification - Updated transaction in question. - Increased token-type balances. - Updated token balance for the related payment method. - Details on the **Token Activity Results** page. - Updated token activity on the customer’s **Account Details** page. | Incremented |
| Refund | A customer who has an AutoBill subscription that references a billing plan transacted in tokens, requests a refund. | Refund an AutoBill transaction that was paid for in tokens. | - Refund notification. - Updated transaction in question. - Increased token-type balances. - Updated token balance for the related payment method. - Details on the **Token Activity Results** page. - Updated token activity on the customer’s **Account Details** page. | Incremented |
| Refund | A customer purchases a product that has tokens granted and then requests a refund. | Refund a one-time purchase transacted in currency for a product for which tokens were granted. | - Refund notification. - Reduced token-type balances. - Updated token balance for the related payment method. - Details on the **Token Activity Results** page. - Updated token activity on the customer’s **Account Details** page. | Decremented |
| Refund | A customer has an AutoBill subscription for a product that has tokens granted and requests a refund. | Refund of an AutoBill subscription transacted in currency for a product for which tokens were granted. | - Refund notification. - Reduced token-type balances. - Updated token balance for the related payment method. - Details on the**Token Activity Results** page. - Updated token activity on the customer’s **Account Details**page. | Decremented |
| **Parent topic:**[Working with Tokens](../topics/ProgGuide_Tokens) | | | | |


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