|
### **支付流程**
One store In-App支付大致由以下四个流程组成。
#### One store會員登錄
欲使用One store In-App支付服务，必須註冊成為One store會員並處於登錄中的狀態。\
如果收到與登錄失敗相關的錯誤代碼(RESULT\_NEED\_LOGIN)，請調用登錄過程以便登錄到One store，或者引導客戶運行One store應用軟件登錄。
* **引導用戶運行One store應用軟件登錄**
利用dialog等，將"您需要登錄One store會員"傳遞給用戶。該方法為用戶提供簡單的指南，並引到用戶直接運行One store應用軟件。
* **使用launchLoginFlowAsync調用登錄流程**
開發公司將使用launchLoginFlowAsync API來調用登錄畫面。\
用户完成登錄後，可以通過IapResultLIstener（在調用API時將其放入parameter中）傳遞結果值。\
如果在驗證結果代碼值後確認為成功，之後就可以使用One store In-App支付SDK的API。\
下圖顯示了開發公司應用軟件和One store之間的登錄流程。
\
請求購買In-App商品
如果想要購買App商品，請先調用商品詳細資訊(queryProductDetailAsync) API，然後拿著收集到的商品資訊，通過launchPurchaseFlow API調用購買頁面。\
支付完成後，您可以通過在初始化PurchaseClient對象時輸入的PurchasesUpdatedListener獲得購買資訊。\
驗證結果代碼值後，如果確認成功，之後進行發放相當於In-App商品的item的流程。 下圖是購買開發公司應用軟件和One store之間In-App商品的流程。
#### 確認購買In-App商品
使用One store IAP library V6以上版本，需要3天内確認購買。如果沒有確認購買，購買金額將退還给客戶。\
使用以下兩種方法可以確認購買。
* **消費 (consume)**
* 管理型商品的特徵是，在購買後使用（consume）前不能再購買。 因此，提供管理型商品中可重複購買的消費性商品时，必須使用PurchaseClient.consumeAsync（）進行使用處理後，客戶才能重新購買該商品。
* 安裝啟動消費性類型的商品時，需要在購買流程完成後立即使用到購買的商品，並在消費完成後發放item。
* 建議用戶在運行應用軟件（遊戲）時或登錄應用軟件（遊戲）時調用上述API，事先確認是否存在未支付的App商品，並添加支付App商品的流程。
* **確認購買商品 (acknowledge)**
* 不是消費性商品時，請使用PurchaseClient.acknowledgeAsync（）。可以不進行使用處理，僅通過購買確認的方式實現永久性商品。
* 安裝啟動永久性類型商品時，需進行確認購買（acknowledge）而不是使用。
* 訂閱類商品也需要確認購買，僅需對首次支付進行確認購買即可。
{% hint style="info" %}
因網絡中斷或App突發非正常終止關閉等原因，有可能發生客戶已完成支付，但傳遞給開發公司的支付資訊發生傳遞遺漏，導致無法支付In-App商品的情况。 建議使用購買資訊導入（queryPurchases）及使用（consume）功能確認是否有購買完成卻未發放的商品，對於未發放的商品需要按照流程進行。
{% endhint %}
#### 訂閱型商品管理
訂閱型商品(subscription)在首次購買後，根據商品支付周期定期更新支付。\
One store為用戶提供定期支付商品管理畫面，具有暫停支付、解除訂閱、變更支付手段等多種功能。 \
可以調用launchManageSubscription API或deep link，提供定期支付管理選單。
### 推薦開發環境
為了應用One store IAP SDK，需要以下開發環境。
* Android 6.0以上版本(API版本23以上)
* [Java SDK 11版本](http://www.oracle.com/technetwork/java/javase/downloads/index.html)
* [Android studio 2.0以上版本](https://developer.android.com/studio/index.html)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://onestore-dev.gitbook.io/dev/cht/tools/billing/v21/ov.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.