Please Select Your Location

Thailand
Australia
Österreich
België
Canada
Canada - Français
中国
Česká republika
Denmark
Deutschland
France
HongKong
Iceland
India
Ireland
Italia
日本
Korea
Latvija
Lietuva
Lëtzebuerg
Malaysia
Malta
Mexico
Nederland
New Zealand
Norge
Polska
Portugal
Russia
Saudi Arabia
Singapore
Southeast Asia
España
Suisse
Suomi
Sverige
台灣
Ukraine
United Kingdom
United States
Việt Nam
المملكة العربية السعودية (Arabic)

類別

IAPurchaseListener.QueryResponse

public class QueryResponse
{
    public string order_id { get; set; }
    public string purchase_id { get; set; }
    public string status { get; set; }//the value of status is "created" or "processing" or "success" or "failure" or "expired"
    public string price { get; set; }
    public string currency { get; set; }
    public long paid_timestamp { get; set; }
}
參數 類型 描述
order_id string 由客戶端產生的唯一訂單 ID。如果為空,則顯示 purchase_id
purchase_id string 購買 ID
status string 購買狀態。可能的值包括: created processing success failure expired
price string 總價
currency string 貨幣代碼
paid_timestamp long 付款時間 (Unix 時間)

此類別在查詢單個項目時儲存 OnQuerySuccess() 回調和 Query() 函數的購買資訊。

IAPurchaseListener.QueryListResponse

public class QueryListResponse
{
    public int total { get; set; }
    public int from { get; set; }
    public int to { get; set; }
    public List<QueryResponse2> purchaseList;
}
參數 類型 描述
total int 條目總數,從 1 開始。
from int [未使用] 查詢開始範圍,預設為 1
to int [未使用] 查詢結束範圍,預設為 == total
purchaseList List< QueryResponse2 >

此類別在查詢使用者購買的完整清單時儲存 OnQuerySuccess() 回調和 Query() 函數的購買數據。購買將以 QueryResponse2 類型的清單形式回傳。

IAPurchaseListener.QueryResponse2

public class QueryResponse2
{
    public string order_id { get; set; }
    public string app_id { get; set; }
    public string purchase_id { get; set; }
    public string user_data { get; set; }
    public string price { get; set; }
    public string currency { get; set; }
    public long paid_timestamp { get; set; }
}
參數 類型 描述
order_id string 由客戶端產生的唯一訂單 ID。如果為空,則顯示 purchase_id
purchase_id string 購買 ID
user_data string Request() 提供的項目名稱
price string 總價
currency string 貨幣代碼
paid_timestamp long 付款時間 (Unix 時間)

此類別將 QueryList() 類別的購買資訊儲存為大清單的一部分。

IAPurchaseListener.Subscription

public class Subscription
{
    public string app_id { get; set; }
    public string order_id { get; set; }
    public string subscription_id { get; set; }
    public string price { get; set; }
    public string currency { get; set; }
    public long subscribed_timestamp { get; set; }
    public TimePeriod free_trial_period { get; set; }
    public TimePeriod charge_period { get; set; }
    public int number_of_charge_period { get; set; }
    public string plan_id { get; set; }
    public string plan_name { get; set; }
    //the value of status is "created" or "processing" or "failure" or "expired" or "ACTIVE" or "NON_RENEWING" or "CANCELED"
    public string status { get; set; }
    public StatusDetail status_detail { get; set; }
}
參數 類型 描述
app_id string VIVEPORT 開發者主控台中的應用程式 ID
order_id string 唯一的購買 ID,可用於查詢或取消
subscription_id string 特定訂閱的 ID
price string 換算為使用者貨幣的價格,字串格式為 "1.50"
currency string 請參閱貨幣清單
subscribed_timestamp long 使用者訂閱的時間
free_trial_period TimePeriod 免費試用期。試用期長度固定不變,不會隨試用過程開始而遞減。
charge_period TimePeriod 訂閱的收費單位,例如 “month” “week”
number_of_charge_period int 收費期數
plan_id string 開發者設定的方案 ID
plan_name string 開發者設定的方案名稱
status string 開發者設定的狀態字串
status_detail StatusDetail 付款歷史紀錄資訊

此類別儲存與訂閱相關的函數數據。 Subscription 回傳訂閱清單時,通常以函數陣列的形式回傳。

請將收費期指定為「月」或「星期」。收費期數表示在訂閱期間該單位的數量。例如: charge_period.timetype == “month” charge_period.value == 1 number_of_charge_period == 12 的結果為按月計費的訂閱期限為一年。

IAPurchaseListener.StatusDetail

public class StatusDetail
{
    public long date_next_charge { get; set; }
    public StatusDetailTransaction[] transactions { get; set; }
    public string cancel_reason { get; set; }
}
參數 類型 描述
date_next_charge long 下一結帳日
transactions StatusDetailTransaction []
cancel_reason string 取消的原因,請參見下文。

此類別儲存有關 Subscription 類別交易的數據。

cancel_reason 的可能值

描述
CANCEL 用戶已取消
OUT_OF_PERIOD 訂閱已過期
PAYMENT_FAIL 付款重試次數過多

IAPurchaseListener.StatusDetailTransaction

public class StatusDetailTransaction
{
    public long create_time { get; set; }
    public string payment_method { get; set; }
    public string status { get; set; }    
    //paymentFailed/pendingWebhook/finish
}
參數 類型 描述
create_time long 訂購時間 (Unix 時間)
payment_method string 付款方式
status string 目前的狀態。可能的值包括: paymentFailed pendingWebhook finish

此類別儲存與 Subscription 類別的付款方式有關的函數數據。

IAPurchaseListener.TimePeriod

public class TimePeriod
{
    public string time_type { get; set; }
    public int value { get; set; }
}
參數 類型 描述
time_type string "month" "day"
value int TimePeriod 中的 time_type 數量

此類別儲存有關 Subscription 類別的付款和訂閱時間長度的資訊。例如,每六個月收費一次的訂閱的 time_type 可能為 “month” value 6