Skip to main content
Vindicia Knowledge Center

Token Activity

CashBox Tokens enable you to support complex billing models that involve tracking units in addition to the fixed price billing cycles that CashBox supports. Use Tokens to define a type of merchant-specific tracking unit that can be incremented or decremented according to customer use (for example, airtime minutes, downloads, incentive points, storage space, gaming currency, and so on.).

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

  • Define Products that allow a customer to purchase Tokens, and Products that are priced in Tokens.
  • Define Billing Plans that grant a customer Tokens, and Billing Plans that bill in Tokens.
  • Define Subscriptions that use Tokens to pay for products or services.

Define one or more Token types, and designate them for use with a Product, Billing Plan, or Subscription. When a customer purchases a Product for which Tokens are included, grant the customer a certain number of units of each Token type as appropriate, and the Token type balances are stored as part of the customer’s Account. For example, if a merchant has defined Token types for Downloads, Logins, and Storage, and has granted them to a Product that a customer purchases, then the Payment Method on the customer’s Account page lists the balances for each separate Token type.

Use CashBox to search for Token Types, view detailed information about individual Tokens, and create new or edit existing Tokens.

Token ID 

The ID of the token to which the listed Activity Type applies.

Customer 

Name of the customer for this Token activity.

Email

Email address of the customer.

Transaction

The transaction that either consumed or granted the Tokens.

Activity Type 

The activity related to the token. Activity types include the following:

  • All—the default, returns results for all types of Token activity.
  • Decrement—activity involving decreasing Token quantities.
  • Purchase—activity involving customer Token purchase activities.
  • Grant—activity involving granting Token quantities to customer(s).
  • Refund—activity involving refunds of Token quantities.
Amount 

Amount related to the Token activity.

Created Date 

Date of the activity. 

Note

Note associated with Token activity if granted or revoked by an agent.

Description 

The token description.