| 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 Detailspage. - 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 Detailspage. - 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 theToken Activity Results page. - Updated token activity on the customer’s Account Detailspage. | Decremented |
| Parent topic:Working with Tokens | | | | |