第 16 章

使用 Payment API

JSR 229 (Payment API) 可讓應用程式代表其使用者執行支付款項。Payment API 透過支付款項配接卡可支援不同的支付款項機制。實作 Payment API 的裝置具有一個或多個配接卡。MIDlet 套裝使用描述元屬性指定可使用的支付款項介面類型。

Sun Java^TM Wireless Toolkit for CLDC 的模擬器採用之支付款項介面範例，可模擬 Premium Priced SMS (PPSMS) 與信用卡支付款項，以實作 Payment API。另外，工具組可讓您輕鬆設定 MIDlet 描述元與 JAR 檔案清單的必要屬性。最後，支付款項主控台可讓您輕鬆追蹤應用程式支付的款項，或支付款項作業失敗事件。

由於 Payment API 與佈建及外部裝置支付款項機制密切相關，而且只有在可信任的保護網域中才能順利支付款項，因此請務必使用工具組的 [經由 OTA 執行] 機制對 Payment API 應用程式進行測試與除錯。如需詳細資訊，請參閱第 2 章。

16.1 支付款項的專案設定

若要調整專案的支付款項屬性，請按一下 [設定]，然後選取 [支付款項] 圖示。

圖 16-1 支付款項設定

已選取 [支付款項] 種類的 [設定] 視窗

JSR 229 (Payment API 規格) 詳細說明了欄位與值。

[一般] 方塊包含有關正在使用的 Payment API 版本以及何處可找到支付款項更新的資訊。若要測試，您可以指定 localhost URL (如螢幕擷取畫面所示)，以直接從專案目錄中擷取更新檔案。

[除錯] 方塊包含可協助測試應用程式的選項。Payment API 規格中對每個選項都作了解釋。

[功能] 方塊列出應用程式可以具有的功能。這些功能對應到每個提供者項下所列的價格資訊。您可以使用 [增加] 與 [移除] 按鈕修改功能清單。

[提供者] 方塊列示了可用於此應用程式的特定支付款項提供者。要支付款項時，模擬器 (或裝置) 會將其中一個可用的支付款項介面，與該應用程式所列出的其中一個提供者配對。您可以使用 [增加]、[編輯] 與 [移除] 按鈕修改提供者清單。如果您增加或編輯某提供者，將顯示如下視窗。

圖 16-2 編輯支付款項提供者

對於每一個支付款項提供者，資訊為名稱、支援的介面、貨幣和支付款項特定資訊。

Payment API 規格中亦詳細說明了這些欄位。

在 [價格資訊] 方塊中，每一行都是一個已定義的支付款項功能。若要編輯價格標籤的值，請在 [值] 欄連按兩下相應的儲存格。

16.2 直接編輯支付款項屬性

支付款項屬性儲存在副檔名為 .jpp 的支付款項更新檔案中。請閱讀該規格以瞭解全部詳細資訊。Sun Java^TM Wireless Toolkit for CLDC 提供了一個公用程式，讓您無論專案設定為何，均可輕鬆編輯支付款項更新檔案。

若要執行公用程式，請選擇 [檔案] > [公用程式]，然後選取 [支付款項編輯] 對話方塊並按下 [啟動]。系統將提示您選取想要編輯的支付款項更新檔案。選擇檔案後，將顯示一個與專案設定的 [支付款項] 區段看起來幾乎一樣的視窗。支付款項編輯公用程式不包含除錯設定。

編輯支付款項更新設定，並在完成後按下 [確定]。由於支付款項更新檔案是使用加密簽署的，因此工具組將顯示金鑰清單，以供您簽署該檔案。選取您要使用的金鑰，然後按下 [簽署支付款項更新檔案]。

16.3 支付款項偏好

若要調整工具組的 Payment API 設定，請選擇 [編輯] > [偏好]，然後按一下 [支付款項]。

圖 16-3 設定支付款項偏好

[偏好] 中 [支付款項] 種類的選項為 [行動電話國家/地區代碼]、[行動電話網路代碼]、[過去的作業事件限制] 和 [主控台電話號碼]。

行動電話國家/地區代碼 (簡稱 MCC) 與行動網路代碼 (簡稱 MNC) 將與 PPSMS 支付款項提供者配合使用。MCC 與 MNC 兩者搭配即可識別裝置所用的無線通信業者。進行支付款項時，MCC 與 MNC 用於從專案設定中的提供者清單中尋找相符提供者。由於模擬器並非實際裝置，因此您可填入適當的 MCC 與 MNC 值，以模擬通信業者。請參閱 Payment API 規格以瞭解更多詳細資訊。

[過去作業事件數量限制] 決定模擬器中所記錄的過去作業事件筆數。這將影響外部事件視窗顯示的清單長度 (如下所述)，以及應用程式自身可擷取的過去作業事件數量。

最後，[主控台電話號碼] 決定支付款項主控台的模擬電話號碼，將在下文中介紹。

16.4 檢視作業事件歷程

模擬器將如同實際裝置一樣追蹤支付款項作業事件。若要查看作業事件歷程，請從模擬器視窗功能表中選擇 [MIDlet] > [外部事件]。按一下 [支付款項作業事件] 標籤。

圖 16-4 檢視支付款項作業事件

已選取 [支付款項作業事件] 標籤的 [外部事件產生器]

支付多次款項後，請按一下 [更新] 以更新清單。選取某作業事件，然後按一下 [詳細資訊] 以在獨立視窗中查看全部詳細資訊。

外部事件視窗僅顯示經由 OTA 執行模擬器時進行的作業事件。儘管無需使用 OTA 便可完成作業事件，但這些作業事件卻不會顯示出來。若要以最逼真的方式模擬支付款項，請務必使用 [經由 OTA 執行] 測試應用程式。

16.5 監視支付款項

Sun Java^TM Wireless Toolkit for CLDC 提供支付款項主控台，可讓您輕鬆查看通過範例支付款項介面的支付款項作業。若要啟動支付款項服務提供者主控台，請選取 [檔案] > [公用程式] > [支付款項主控台]。

圖 16-5 支付款項主控台

[支付款項服務提供者主控台] 視窗顯示支付款項作業事件的訊息

另外，您可以使用網路監視器檢視作業事件。信用卡作業事件使用 HTTPS 完成，而 PPSMS 作業事件使用 SMS。如需網路監視器的完整描述，請參閱第 5 章。

ing HT