# ONE Billing Lab指南

<figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2FlX56KLT4jLi38DaqE9Ve%2Fimage.png?alt=media&#x26;token=211e0ad6-eff5-43cd-9ca1-3c3f79785c82" alt=""><figcaption></figcaption></figure>

#### 📌 ONE Billing Lab作為研發工具，可以幫助研發者更容易確認ONE store服務各國家In-App付款庫綜合狀態。

* 不需要單獨安裝各服務國用的ONE store App，以希望國家會員登錄后就可以進行付款測試。
* 沒聯動實際ONE store支付系統，也可以通過ONE Billing Lab的回應模擬程式功能測試付款流程。

<figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2FTtg4zzN1SI1b4sfqe7hM%2Fimage.png?alt=media&#x26;token=dbaa6662-5c31-47ac-bea0-6013a84e35d8" alt=""><figcaption></figcaption></figure>

## **功能介紹** <a href="#onebillinglab-gong-neng-jie-shao" id="onebillinglab-gong-neng-jie-shao"></a>

**✅ 綜合測試環境**

* 大韓民國、新加坡、臺灣、美國等所有ONE store環境中，可以僅通過ONE Billing Lab App進行測試。
* 提供統一的測試環境，減少研發公司們因各STORE套餐名不同而帶來的測試困難。

**✅ 回應模擬程式**

* 可以不通過實際付款過程，測試In-App付款場景。
* 在研發和QA環境中測試付款回應動作時使用。

**✅ 諸多付款場景測試**

* 可以測試定期付款管理、使用者認證、生物認證等諸多付款相關功能。
  * 定期付款管理功能表僅在以大韓民國和美國會員登錄時顯示。

<figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2FEDEyGjJtNZTQsxK77PAE%2Fimage.png?alt=media&#x26;token=6f4947d7-7aba-4ac9-96b2-bfd6131a5b0f" alt=""><figcaption></figcaption></figure>

## **測試方法** <a href="#onebillinglab-ce-shi-fang-fa" id="onebillinglab-ce-shi-fang-fa"></a>

<figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2FJUjIJpJdlsXjdEqEdO19%2Fimage.png?alt=media&#x26;token=91b15892-65e0-4739-8e79-f1afe30cc2cb" alt=""><figcaption></figcaption></figure>

### 1. 安裝ONE Billing Lab <a href="#onebillinglab1.-an-zhuang-onebillinglab" id="onebillinglab1.-an-zhuang-onebillinglab"></a>

* 在ONE store App或GitHub下載安裝ONE Billing Lab。
  * [在ONE store App安裝](https://onesto.re/0001002700)
  * [在GitHub安裝](https://github.com/ONE-store/one_billing_lab)

### 2. 生成及登錄ONE store帳戶 <a href="#onebillinglab2.-sheng-cheng-ji-deng-lu-onestore-zhang-hu" id="onebillinglab2.-sheng-cheng-ji-deng-lu-onestore-zhang-hu"></a>

* 啟動ONE Billing Lab后，選擇測試國家或地區，生成或登錄ONE store帳戶。
  * ONE Billing Lab會員和原有會員一致。
* 若原有ONE store帳戶，可以直接進行第三階段。
* 沒有帳戶的，可在ONE Billing Lab簡單加入會員。

<figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2FvH3VE7D4xPa9e6yGTCfX%2Fimage.png?alt=media&#x26;token=0920dc7c-2866-4e89-90e2-2296e063ee66" alt=""><figcaption></figcaption></figure>

### 3.註冊測試ID <a href="#onebillinglab3.-zhu-ce-ce-shi-id" id="onebillinglab3.-zhu-ce-ce-shi-id"></a>

* 在ONE store研發者中心測試App中，以付款測試ID註冊ONE store帳戶。
* 註冊時可以選擇付款環境。
  * Sandbox
  * Commercial (商用測試)
* 參考 :  [註冊測試ID](https://onestore-dev.gitbook.io/dev/cht/tools/billing/v21/test#inapp-zhi-fu-ce-shi-ji-an-quan-xing-zhu-ce-ce-shi-id)

<figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2FiQvi2o8qZjSUTsGwVWd6%2Fimage.png?alt=media&#x26;token=97edf6f9-0a4e-4dd9-a2bb-657e4d7f0618" alt=""><figcaption></figcaption></figure>

### 4. App 聯動設置 <a href="#onebillinglab4.app-lian-dong-she-zhi" id="onebillinglab4.app-lian-dong-she-zhi"></a>

* 設置聯動測試的研發者App的 `AndroidManifest.xml`檔案。
  * 為了指定商店，把研發者選項（`onestore：dev_option`的`android：value` 值）設置為`onestore_03`。

<pre class="language-xml"><code class="lang-xml">&#x3C;manifest>
    &#x3C;application>
<strong>        &#x3C;meta-data android:name="onestore:dev_option" android:value="onestore_03" />
</strong>    &#x3C;/application>
&#x3C;/manifest>
</code></pre>

* 參考: [選擇商店設置開發者選項](https://onestore-dev.gitbook.io/dev/cht/tools/billing/v21/sdk#undefined-3)

### 5. 進行付款測試 <a href="#onebillinglab5.-jin-xing-fu-kuan-ce-shi" id="onebillinglab5.-jin-xing-fu-kuan-ce-shi"></a>

* 運行研發者App試圖付款。
* 按照註冊ONE store帳戶的國家和研發者中心設置的付款環境基準，顯示付款畫面。
* 例如\
  : 美國會員 + 商用付款環境 → 顯示實際付款畫面和付款手段，實際付款功能

<figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2FaO8tMUVF69ibpzrf8kWO%2Fimage.png?alt=media&#x26;token=76604714-b7ee-4722-a29b-a9f6a8e90eb8" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
為進行在商用測，必須在 ONE store Developer Center 登記 Binary。
{% endhint %}

| 條件         | 商用測試 (uploadKey) | 商用測試 (store signingKey) | Sandbox 測試 | 備註           |
| ---------- | ---------------- | ----------------------- | ---------- | ------------ |
| 未登記 Binary | ✖ 不可             | ✖ 不可                    | ✔ 可行       | 僅可使用 Sandbox |
| 已登記 Binary | ✔ 可行             | ✔ 可行                    | ✔ 可行       | 通過簽名驗證後全     |

### 6. 確認付款記錄及取消付款 <a href="#onebillinglab6.-que-ren-fu-kuan-ji-lu-ji-qu-xiao-fu-kuan" id="onebillinglab6.-que-ren-fu-kuan-ji-lu-ji-qu-xiao-fu-kuan"></a>

* 可以在ONE store研發者中心確認付款記錄。
* 需要時可以親自處理取消付款。
