Payment System

The Payment System of SGUtil For Unity provides following methods.

Get Product List

void GetProductList(string filter)

• filter - the string parmater to be passed to getProductList method of game server, used by game server to filter/control results.

• Retrieve product(property) list from game server.
• Product(Property) list is notified via OnProduct.

Get Product List Callback

void OnProduct(SGUResult resultCode, SGUProduct product)

• resultCode - result code
• product - Product information, see SGU.cs for its member definition. Refer to UProduct.

• Product notification begins with RESULT_ITEM_BEGIN, followed by RESULT_ITEM, and ends with RESULT_ITEM_END.

Buy Product

void Buy(string product_id)

• product_id - product ID

• Starts up progress of product purchase.
• Generation of order and its state change are notified via OnOrderStateChange. The caller must save the order ID for future use.
• The result of payment UI operation is notified via OnPay.
• OnOrderStateChange is called before OnPay to notify order generation and state change.

Buy Product Callback

void OnPay(SGUResult resultCode)

• resultCode - result code

• 'result' being RESULT_OK indicates user confirmed to pay and the order was accepted by channel. The caller may call GetOrderState to confirm whether correct amount of money has been transferred to account.

Get Order State

void GetOrderState(string order_id)

• order_id - order ID

• This method is typically called after user completed payment UI operation to confirm whether correct amount of money has been transferred to account.
• Please note success of payment UI operation DO NOT INIDICATE success of money transfer.
• The result is notified to caller via OnOrderStateChange.

Get Order State Callback

void OnOrderStateChange(SGUResult resultCode, SGUOrderState order_state)

• resultCode - result code
• order_state - order state

• This callback is initiated after Buy or GetOrderState are called.
• SGUOrderState's member 'OrderID' is null when member 'State' is "ordering"，it has a fulfilling value after 'State' becomes "ordered". The caller should save the order ID for future state query and management.
• For values of SGUOrderState's member 'State', please refer to SGAgent.SGClient.onOrderStateChange. However, if 'State' is 'error', it means GetOrderState cannot be done at present.

Get Treasure List

void GetTreasureList(string filter)

• filter - the string parmater to be passed to getTreasureList method of game server, used by game server to filter/control results.

• Retrieve treasure list owned by the user from game server.
• Treasure data are notified via OnTreasureList.

Get Treasure List Callback

void OnTreasureList(SGUResult resultCode, SGUTreasure treasure)

• resultCode - result code
• treaure - treasure data, see SGU.cs for its member definition.

• Treasure data notification begins with RESULT_ITEM_BEGIN, followed by RESULT_ITEM, and ends with RESULT_ITEM_END.