Before Using Purchase Menu

gamebase_purchase_01_201812 To use the purchase menu, currency must be selected for purchase metrics. It can be set only once initially, and the Analytics sales metrics show in the currency code as configured. Please be cautious with your choice, since the currency code cannot be modified, once selected.

Game > Gamebase > Console User Guide > Purchase

You can register in-app purchase information and view the history. Gamebase uses NHN Cloud IAP (In-App Purchase) service.

Store

Register stores to sell products in games. Register a new store on the Store Information List of the Store tab, or manage registered stores. gamebase_purchase_01_201812_en

Register

Click Register on the Store Information List to register a new store.

gamebase_purchase_02_201812_en

  • Store Select an external store to register. If it is not on the list, contact Customer Center.
  • App Name Enter the name of a game to register.
  • Store App ID Enter information issued by store.
  • Use or Not Select whether to use the store or not.

[Note] Validation of receipts from Google Play Store

When Google's receipt validation system experiences failure, you can use the Gamebase's internal signature validation to properly process the purchase by setting the Receipt validation settings for onetime products to 1-step validation. 2-step validation is always performed for subscription products regardless of the setting.

Modify

Retrieve or modify detail information of registered stores on the list.

gamebase_purchase_03_201812_en - Select a registered store on the list to retrieve detail information. - Click Modify to modify information such as app name, store app, and use or not, but not store App ID. - Click Delete to delete information: only for the stores that are Not in Use.

Product

You can register products to sell at the store. In the Product tab, you can register a new product or manage the registered products. - (1) Register : You can use a single Store Item ID to register multiple products. - (2) Change store item status : You can use a single Store Item ID to change whether to use the registered products all at once. - (3) Filter : Provides filters for usage, store/store item ID/product ID, product name to allow easy search. When there is no search value, the list of products from all stores is displayed.

gamebase_purchase_04_202006

Register

To register a new product, click Register on the Product List page.

1. User-input Registration

gamebase_ban_01_201812

  • (1) Product ID: Enter product ID to request for purchase. Purchase API must be called from SDK with a product ID so as to purchase the corresponding product.
  • (2) Product Name: Enter name to show for purchase. Purchase history as well as metrics can be listed by the name.
  • (3) Use: Select whether to use a product. At the request of SDK for the list of products, those SDK that are selected as 'USE' only are listed.
  • (4) More Products: To register more products, click + to add input lines.
  • (5) Store: Select an external store to register. If there's none, first register a store at Store.
  • (6) Store Item ID: Enter ID issued after store is registered. The item registered in the Gamebase product list is purchased using this information at the request of purchase to the selected store.
  • (7) Store Item Type: Select the type of product to register. For Google Play and App Store, items can be registered for subscription, and for other stores, only one-time item registration is available.

2. File-uploading Registration

gamebase_ban_01_201812

  • Products can be registered by uploading files.
  • Up to 1,000 products can be registered at once.
  • Be cautious with the input type, since a product may not be properly registered with invalid input type.
  • Korean may not be saved properly if the file is not encoded in 'UTF-8'.
  • When it fails to register files, you may download failed list from Download at the result popup.

Modify

Query details or change information of a registered product from the list. gamebase_ban_01_201812 - Select each item from the list to query details. - Click Modify to change information, except Store, Item Number, and Product Type. - Only Product Name, Use, and Store Item ID are modifiable, and the others cannot be changed. - Store Item ID is only modifiable with other already registered Store Item ID, and a new Store Item ID requires product registration.

Transactions

Purchase information can be queried. Select a search type in need and query purchase information. To query the list of purchases, click Download on top right of the page.

Properties

Search conditions

Each search type shows different search items.

gamebase_ban_01_201812

Search is available by the following conditions: - Search Period: A period when user attempted to purchase, in the ascending or descending order - Store: Information of store to search - Store Item ID: ID issued after store is registered - Item: Select an item to search - User ID: User ID that made the purchase - Purchase Status: Status of purchase to search

(2) Search by Transaction ID

gamebase_ban_01_201812

Search is available by Transaction ID which is created upon purchase.

(3) Search by Receipt

gamebase_ban_01_201812 You can view the results using the receipt issued during the purchase.

Search results

The search results are as follows:

  • Transaction ID: Unique number for identifying purchases within Gamebase
  • Store: Information about the store where the purchase has been made
  • User ID: User ID that made the purchase
  • Product name: The name of the actual product that user purchased in app
  • Product ID (Store item ID): The actual ID of the product purchased by the user in app, and the ID of the store to which the actual purchase has been made
  • Store item type: Type of the actual product that was purchased by the user in app
  • Price/monetary unit: The price and monetary unit of the item purchased by the user
  • Consume status: Whether the purchased item has been provided
  • Purchase status: The current status of the purchase
  • Store Reference Key: Unique purchase number issued by the store
  • Scheduled purchase date: Time when a user attempted purchase
  • Purchase date: Time when a user completed purchase
  • Refund date: Time when a user's item was refunded
  • Additional information: Additional information delivered by SDK when the purchase was requested (Developer payload)

Change purchase status

The status of the searched purchase information is as follows: - Purchase successful (Success) - Purchase has been made successfully. - Can be changed to the Refund status. - Ready to make purchase (Reserved) - No longer proceeding with purchase through the store, or did not proceed with purchase validation. - Can be changed to Success or Refund status. - Failed to validate purchase (Failure) - The store proceeded with the purchase, but an error occurred during purchase validation. - Can be changed to Success or Refund status. - Refund successful (Refund) - The administrator manually updated the refund status in the store. - Cannot be changed to any other purchase status. - Canceling during the purchase process (UserClose) - User has withdrawn the purchase

Changing to Success

gamebase_purchase_08_201812_en In order to proceed, you need to provide Receipt Number, Value, and Currency.

Changing to Refund

gamebase_purchase_09_201812_en No additional information is required. Once it has been changed to Refund status, it's set for good.

Validate Receipt

image alt * Validates transaction of the retrieved receipt. * You can see the results of comparing each field. The response value is provided in JSON format, so you can directly check the data if needed. * For now, only App Store transactions can be validated.

Monitor Purchase Abuse

You can view purchase abuse information and set automatic lockdown/release.

Query Refund History

image alt

Purchase and refund information can be queried by search conditions as below. Click Download on top right to download purchase and refund list at any time.

Search Conditions

  • Refund Date: Time when a user item was refunded
  • User ID: User ID that made the purchase
  • Refund Count: Refund count of the user. Only the items with count higher than input value are queried.
  • Refund Amount: Refund amount of the user. Only the items with amount higher than input amount are queried.
  • Store: The store where refund was made

Search Results

  • User ID: User ID that made the purchase
  • Store: Information of a store where purchase has been made
  • Refund Count: Refund count of the user
  • Refund Amount: Refund amount of the user
  • Purchase Count (Query Period): Purchase count of the user during query period
  • Purchase Amount (Query Period): Purchase amount of the user during query period
  • Purchase Count (Accumulated): Total accumulated purchase count of the user
  • Purchase Amount (Accumulated): Total purchase amount of the user
  • Purchase Count (Recent 3 months): Purchase count of the user during the last three months
  • Purchase Amount (Recent 3 months): Purchase amount of the user during the last three months
  • Status: Current status of the user
  • Change Status: Ban or release depending on the user status

Change Status

gamebase_member_02_201812

The feature allows to change status of the game user's account. Each status is available for change like below:

  • Normal: Can be changed to ban or withdrawal status. Please note that, once withdrawn, user's account information cannot be reverted.
  • Ban: Ban can be released.
  • Ban Suspended: Can be changed to ban status.
  • Withdrawal: The button is not displayed, because the status cannot be changed.

Check Purchase History

You can query detailed purchase history during the search period by clicking a user ID on the list.

image alt

Purchase History

  • Scheduled purchase date: Time when a user attempted purchase
  • Purchase date: Time when a user completed purchase
  • Refund date: Time when a user's item was refunded
  • Transaction ID: Unique number to identify purchases within Gamebase
  • Store: Information of a store where purchase has been made
  • Item Name: Name of actual item which the user purchased from the app
  • Price: Price of item purchased by the user
  • Currency: Type of currency used by the user for purchase
  • Purchase Status: Current status of purchase

Query the History of Automatic Release for Purchase Abuse

image alt

You can search for user information on automatic release for purchase abuse by using the following search conditions.

Search Conditions

  • Search Period: Query is performed based on the time when ban suspension started.
  • User ID: User ID for ban suspension
  • Purchase Count: The number of purchases made by the user during the ban suspension period. Only the items with count higher than input value are queried.
  • Purchase Amount: The purchase amount of the user during the ban suspension period. Only the items with amount higher than input amount are queried.

Search Results

  • User ID: User ID for ban suspension
  • Ban Suspension Period: Ban suspension start and end time
  • Purchase Count (Release Condition): Total number of purchases required to release ban
  • Purchase Amount (Release Condition): The total amount to purchase to release ban
  • Release Conditions Satisfying: Conditions (AND, OR) to satisfy the release condition
  • Purchase Count (Suspension Period): Total accumulated number of purchases made by the user during the ban suspension period
  • Purchase Amount (Suspension Period): Total amount purchased by the user during the ban suspension period

Check Purchase History

You can query detailed purchase history during the search period by clicking a user ID on the list. (Note that users without purchase history shows up as inactivated.)

image alt

Purchase History

  • Purchase Date: Time when a user completed purchase
  • Transaction ID: Unique number to identify purchases within Gamebase
  • Store: Information of a store where purchase has been made
  • User ID: User ID that made the purchase
  • Store Item ID: Actual store item ID that the user purchased in the app
  • Purchase Amount: Amount of purchase

Set Automatic Lockdown for Purchase Abuse

Click Enable to enable the auto lockdown setting, and enter value.

image alt

Setting Information

image alt

  • Ban Period Enter the ban period to be applied for auto lockdown.
    • Permanent Ban: To be selected for a permanent ban.
    • Temporary Ban: Enter period for a temporary ban (days).
  • Setting Conditions for Automatic Lockdown Users that meet set conditions are automatically locked down. At least one setting is required.
    • Refund Count: Enter refund count due to abusive acts.
    • Refund Amount: Enter refund amount due to abusive acts.
  • Setting Messages for Automatic Lockdown
    • Enter a ban message to show to users.
    • Enter messages in multiple languages on a template to allow easy re-use. Select and register a pre-registered template.
  • Deleting Leaderboard
    • Set whether to delete Leaderboard of the game user as well, along with auto-lockdown.
    • With registration, game user's data is to be deleted from the leaderboard, and note that such data cannot be recovered.

Set Automatic Release for Purchase Abuse

To use the automatic release setting, click the Use button and enter the setting value. To enable the automatic release setting, the automatic lockdown setting must be enabled.

image alt

Setting Information

image alt

  • Temporary ban release period: Enter the ban suspension period when automatic released is applied.
  • Set the conditions for releasing the ban: Set the conditions required for automatic release. At least one field must be set.
    • Purchase Count: Enter the number of purchases for automatic release.
    • Purchase Amount: Enter the amount to purchase for automatic release.
  • Ban release message
    • Enter a ban release message to be displayed to the user.
    • Templates with messages to be displayed to users entered in multiple languages are provided so that users can easily reuse the message. Select a pre-registered template and register the template.
TOP