Configuring revocation rules

Last updated on August 9, 2023

Overview

Revocation service enables you to configure and customize your revocation strategy logic for durable and consumable entitlements and virtual currencies. This guide focuses on teaching you how to configure revocation rules and explaining the implications of each rule.

Goals

• Guide users to configure revocation rules correctly based on their preferences and business needs.

Prerequisites

• Store, wallets and in-app purchase services are configured properly.
• If the user intends to use customized revocation rules, the custom service address must be configured properly.

How to configure revocation strategies

Virtual Currency Revocation

1. Go to the E-Commerce section, find the Revocation section, and click 'Configurations' to expand it. If you would like to enable virtual currency revocation, turn on the 'Allow Revocation' toggle and choose your preferred revocation strategy.
   1. Fail Revocation if Wallet Balance would drop below 0: When the amount to be revoked is greater than a player's wallet balance, the revocation will be failed.
   2. Allow negative wallet balance: When the amount to be revoked is greater than a player's wallet balance, the player's wallet balance will be deducted accordingly and become negative.
   3. Customization: Use your own custom revocation strategy by using gRPC Custom Service.

注記

1. Virtual currencies can only be deducted from their corresponding wallets.
2. Custom Service gRPC Server Address needs to be configured if you would like to use customization.

Durable entitlements revocation

2. Select the 'Entitlement (Durable)' tab to configure strategies for durable entitlements.
   1. Default: Entitlement will be revoked from the player’s account.
   2. Customization: Use your own custom revocation strategy by using gRPC Custom Service.

Consumable entitlements revocation

3. Select the 'Entitlement (Consumable)' tab to configure strategies for consumable entitlements.
   1. Default: Only consumable entitlements that are unused or with enough use count will be revoked from players.
   2. Customization: Use your own custom revocation strategy by using gRPC Custom Service.

How to view revocation history

4. Click the Revocation History section under Revocations. A table of all historical revocation records is displayed. On this page, you may narrow your search by using the All Source and All Status filters, or search individual user records by using the 'Search by User ID' search box.
   1. All Source: This includes Order, DLC, and Other, which indicates where these revocations came from.
   2. All Status: This includes Success and Failed.

5. Click the 'View' link to view all details related a specific revocation record.