當用戶在應用市場里下載APP，體驗了免費的基礎功能和服務后，通過自主選擇付費，以獲取和使用應用內提供的增值服務——這種用戶應用內購買行為的完成，就需要用到應用內支付（In-App Purchases，簡稱IAP），
應用內支付有豐富的使用場景和需求，游戲類應用中裝備和虛擬幣的購買、視頻類應用中會員的訂閱、知識工具類應用中一次性購買開高級服務和功能……應用內支付大大拓寬了移動開發的盈利模式，增加了APP營收的靈活性，
在華為移動生態體系中，我們為開發者提供了安全好用的應用內支付基礎開發服務，助力開發者降本增效，實作付費轉化和持續營收，
本文將詳解應用內支付開通啟用、商品管理、測驗和上架等環節操作步驟，呈現應用內商品生成全程序，讓開發者輕松實作從入門運用和熟練掌味訓為應用內支付服務，
IAP的啟用及商品管理方法
啟用服務
1.開啟服務開關
1.1. 登錄 AppGallery Connect 網站，選擇“我的專案”，在專案串列中找到相應專案，在專案下的應用串列中選擇需要開通服務的應用，
1.2. 在所選應用頁面中點擊<我的專案>，進入“API管理”頁簽，打開需要開通服務所在行的開關，
*API管理：在此頁簽確認和開通所需服務能力，支持一個服務有多個API開關，可單獨控制各API開啟或關閉，也可通過該服務右側的API總開關一鍵開啟或關閉該服務下的全部API，
2.配置支付服務引數
2.1. 在所選應用頁面左側導航欄選擇[ 盈利 > 應用內支付服務 ]，點擊[ 設定 ]，
如果首次配置會彈出簽署協議彈框，
2.2. 點擊“訂閱通知地址”后的“√”圖示，配置訂閱通知地址，
2.3. 配置完成點擊“√”，
創建商品及沙盒測驗
1、創建商品：全球定價，一個版本搞定
登錄AppAallery Connect，在[ 我的應用 ]界面選擇應用，進入[ 運營 ]頁面，
*資料資訊為模擬
在[ 運營 ]頁面左側導航欄選擇[ 產品運營 > 商品管理 ]，選擇[ 商品串列 ]，點擊[ 添加商品 ]，
1.1相關引數說明：
①確認創建的商品型別：華為應用內支付支持三種商品型別：
消耗型商品：即可以消耗使用的商品，比如游戲類應用中的金幣、鉆石、點券等,可用來兌換和購買應用內虛擬服務和物品的貨幣，
非消耗型商品：即購買后永久使用的商品，比如游戲中特別篇關卡、教育類應用中無限時的課程學習權限等
訂閱型商品：即一種預定支付方式，購買后未來一段時間內允許訪問增值更能或內容，周期結束后自動續期購買下一期的服務，比如音視頻類、教育課程類應用中的月度會員等，
根據你所需添加的商品屬性，來勾選商品型別進行進一步填寫，
②商品ID：以大小寫字母及數字開頭，由字母、數字及下劃線 (_) 和句點 (.)組成，字符輸入上限148個，一個應用內商品ID不能重復，保存后不能修改，洗掉后無法再次使用，
③語言：點擊[管理語言串列]，勾選需支持的語言種類
④商品名稱：不能為空，字符上限55個，不支持特殊字符|
⑤商品簡介：不能為空，字符上限100個，不支持特殊字符|
⑥商品價格：點擊“查看編輯”，為商品適配合適價格，
1.2面向全球的商品資訊設定：如果你的應用開發面向全球多個國家，無需維護管理多個地域版本，
多語言設定：創建商品時，在<語言>欄，勾選需支持的國家語言，并在<商品名稱>一欄，輸入對應國家語言的商品名及資訊，
全球實時匯率定價參考：不同國家及地域的價格設定，只需定義一個商品價格，不同國家和地區價格會根據當地匯率來計算并顯示，給開發者提供當地定價依據，也可自定義單個地域定價，
商品資訊填寫完成后，點擊[編輯價格]，即可進入商品價格編輯界面，
根據以上操作步驟，完成商品創建，回到商品串列頁面進行商品的狀態編輯，點擊<生效>，即添加商品完成，
相關引數說明：
- 通用幣種要求國家/地區：支持整數或兩位小數，如輸入1.34，則默認選取1.34作為該商品的輸入價格；
- 特殊幣種要求國家/地區：
- 僅支持整數的國家/地區，整數或向上取整作為輸入價格，如輸入5.02，則默認選取6.00作為該商品的輸入價格；
- 僅以五分之一為最小單位的國家/地區，整數或向上取符合五分之一要求的數值作為輸入價格，如輸入1.23，則默認選取1.40作為該商品的輸入價格，
注意：華為在每月的月初都會郵件通知開發者去修改后臺商品價格，開發者在收到郵件后，應該手動地去重繪相關商品的價格，以免出現匯率差距太大導致的虧損，
1.3商品激活
填寫好資訊點擊[保存]，回傳商品串列，新添加商品會顯示處于[失效]狀態，點擊確認[激活]，商品即生效，
2、客戶端接入，支付程序開發指南
2.1判斷是否支持應用內支付
在使用應用內支付之前，你的應用需向華為應用內支付發送isEnvReady請求，以此判斷用戶當前登錄的華為帳號所在的服務地是否在華為IAP支持結算的國家/地區中，如果應用未接入華為帳號的登錄介面，可通過該介面完成登錄操作，
開發步驟如下：
發起isEnvReady請求，并設定兩個回呼監聽來接收介面請求的結果，
- 當介面請求成功時，你的應用將獲取到一個IsEnvReadyResult實體物件，表示用戶當前登錄的華為帳號所在的服務地支持IAP，
- 當介面請求失敗時，IAP會回傳一個Exception物件，若該物件為IapApiException物件，可使用其getStatusCode()方法獲取此次請求的回傳碼，
當回傳帳號未登錄（OrderStatusCode.ORDER_HWID_NOT_LOGIN）時，可使用IapApiException物件中的status拉起華為帳號登錄頁面，此后在Activity的onActivityResult方法中獲取結果資訊，從onActivityResult回傳的intent中決議出returnCode，當returnCode=OrderStatusCode.ORDER_STATE_SUCCESS時，則表示當前帳號所在服務地支持IAP，其他則表示此次請求有例外，
*Status不支持序列化，請勿對IAP介面回傳的Status物件執行序列化操作，
// 獲取呼叫介面的Activity物件
final Activity activity = getActivity();
Task<IsEnvReadyResult> task = Iap.getIapClient(activity).isEnvReady();
task.addOnSuccessListener(new OnSuccessListener<IsEnvReadyResult>() {
@Override
public void onSuccess(IsEnvReadyResult result) {
// 獲取介面請求的結果
int accountFlag = result.getAccountFlag();
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof IapApiException) {
IapApiException apiException = (IapApiException) e;
Status status = apiException.getStatus();
if (status.getStatusCode() == OrderStatusCode.ORDER_HWID_NOT_LOGIN) {
// 未登錄帳號
if (status.hasResolution()) {
try {
// 6666是您自定義的常量
// 啟動IAP回傳的登錄頁面
status.startResolutionForResult(activity, 6666);
} catch (IntentSender.SendIntentException exp) {
}
}
} else if (status.getStatusCode() == OrderStatusCode.ORDER_ACCOUNT_AREA_NOT_SUPPORTED) {
// 用戶當前登錄的華為帳號所在的服務地不在華為IAP支持結算的國家/地區中
}
} else {
// 其他外部錯誤
}
}
});
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == 6666) {
if (data != null) {
// 使用parseRespCodeFromIntent方法獲取介面請求結果
int returnCode = IapClientHelper.parseRespCodeFromIntent(data);
// 使用parseAccountFlagFromIntent方法獲取介面回傳的帳號型別
int accountFlag = IapClientHelper.parseAccountFlagFromIntent(data);
}
}
}
2.2展示商品資訊
在華為AppGallery Connect網站上完成商品的配置后，需在你的應用中使用obtainProductInfo介面來獲取此類商品的詳細資訊，
開發步驟如下：
- 構建請求引數ProductInfoReq，發起obtainProductInfo請求并設定
OnSuccessListener和OnFailureListener回呼監聽器以接收介面請求的結果，您需要在ProductInfoReq中攜帶您此前已在華為AppGallery Connect網站上定義并生效的商品ID，并根據實際配置的商品指定其priceType，
*obtainProductInfo每次只能查詢一種型別的商品， - 當介面請求成功時，IAP將回傳一個ProductInfoResult物件，您的應用可通過該物件的getProductInfoList方法獲取到包含了單個商品資訊的ProductInfo物件的串列，您可以使用ProductInfo物件包含的商品價格、名稱和描述等資訊，向用戶展示可供購買的商品串列，
List<String> productIdList = new ArrayList<>();
// 查詢的商品必須是您在AppGallery Connect網站配置的商品
productIdList.add("ConsumeProduct1001");
ProductInfoReq req = new ProductInfoReq();
// priceType: 0：消耗型商品; 1：非消耗型商品; 2：訂閱型商品
req.setPriceType(0);
req.setProductIds(productIdList);
// 獲取呼叫介面的Activity物件
final Activity activity = getActivity();
// 呼叫obtainProductInfo介面獲取AppGallery Connect網站配置的商品的詳情資訊
Task<ProductInfoResult> task = Iap.getIapClient(activity).obtainProductInfo(req);
task.addOnSuccessListener(new OnSuccessListener<ProductInfoResult>() {
@Override
public void onSuccess(ProductInfoResult result) {
// 獲取介面請求成功時回傳的商品詳情資訊
List<ProductInfo> productList = result.getProductInfoList();
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof IapApiException) {
IapApiException apiException = (IapApiException) e;
int returnCode = apiException.getStatusCode();
} else {
// 其他外部錯誤
}
}
});
2.3發起購買
AppGallery Connect網站支持托管的商品包括消耗型商品，非消耗型商品和訂閱型商品，您的應用可通過createPurchaseIntent介面發起購買請求，開發步驟如下：
- 構建請求引數PurchaseIntentReq，發起createPurchaseIntent請求，您需要在PurchaseIntentReq中攜帶您此前已在AGC網站上定義并生效的商品ID，當介面請求成功時，您可獲取到一個PurchaseIntentResult物件，其getStatus方法回傳了一個Status物件，您的應用需要通過Status物件的startResolutionForResult方法來啟動華為IAP收銀臺，
*Status不支持序列化，請勿對IAP介面回傳的Status物件執行序列化操作，// 構造一個PurchaseIntentReq物件 PurchaseIntentReq req = new PurchaseIntentReq(); // 通過createPurchaseIntent介面購買的商品必須是您在AppGallery Connect網站配置的商品， req.setProductId("CProduct1"); // priceType: 0：消耗型商品; 1：非消耗型商品; 2：訂閱型商品 req.setPriceType(0); req.setDeveloperPayload("test"); // 獲取呼叫介面的Activity物件 final Activity activity = getActivity(); // 呼叫createPurchaseIntent介面創建托管商品訂單 Task<PurchaseIntentResult> task = Iap.getIapClient(activity).createPurchaseIntent(req); task.addOnSuccessListener(new OnSuccessListener<PurchaseIntentResult>() { @Override public void onSuccess(PurchaseIntentResult result) { // 獲取創建訂單的結果 Status status = result.getStatus(); if (status.hasResolution()) { try { // 6666是您自定義的常量 // 啟動IAP回傳的收銀臺頁面 status.startResolutionForResult(activity, 6666); } catch (IntentSender.SendIntentException exp) { } } } }).addOnFailureListener(new OnFailureListener() { @Override public void onFailure(Exception e) { if (e instanceof IapApiException) { IapApiException apiException = (IapApiException) e; Status status = apiException.getStatus(); int returnCode = apiException.getStatusCode(); } else { // 其他外部錯誤 } } }); - 在你的應用拉起收銀臺并且當用戶完成支付后（成功購買商品或取消購買），華為IAP會通過onActivityResult方式將此次支付結果回傳給應用，可使用parsePurchaseResultInfoFromIntent方法獲取包含結果資訊的PurchaseResultInfo物件，
- 當用戶購買成功時，可從PurchaseResultInfo物件中獲取到購買資料InAppPurchaseData及其簽名資料，您需要使用在華為AppGallery Connect分配的公鑰進行簽名驗證，公鑰獲取和驗證方法請參見對回傳結果驗簽，
- 用戶購買消耗型商品時，如果回傳以下支付例外則需要檢查是否存在掉單情況，具體請參見消耗型商品的補單流程，
- 支付失敗（OrderStatusCode.ORDER_STATE_FAILED）
- 已擁有該商品（OrderStatusCode.ORDER_PRODUCT_OWNED)
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == 6666) {
if (data == null) {
Log.e("onActivityResult", "data is null");
return;
}
// 呼叫parsePurchaseResultInfoFromIntent方法決議支付結果資料
PurchaseResultInfo purchaseResultInfo = Iap.getIapClient(this).parsePurchaseResultInfoFromIntent(data);
switch(purchaseResultInfo.getReturnCode()) {
case OrderStatusCode.ORDER_STATE_CANCEL:
// 用戶取消
break;
case OrderStatusCode.ORDER_STATE_FAILED:
case OrderStatusCode.ORDER_PRODUCT_OWNED:
// 檢查是否存在未發貨商品
break;
case OrderStatusCode.ORDER_STATE_SUCCESS:
// 支付成功
String inAppPurchaseData = purchaseResultInfo.getInAppPurchaseData();
String inAppPurchaseDataSignature = purchaseResultInfo.getInAppDataSignature();
// 使用您應用的IAP公鑰驗證簽名
// 若驗簽成功，則進行發貨
// 若用戶購買商品為消耗型商品，您需要在發貨成功后呼叫consumeOwnedPurchase介面進行消耗
break;
default:
break;
}
}
}
2.4確認交易
用戶完成一次支付之后，你需根據購買資料InAppPurchaseData的purchaseState欄位來判斷訂單是否已成功支付，若purchaseState為已支付（取值為0），你需發放相應的商品或提供相應的服務，此后需要向華為IAP發送發貨確認請求，
- 對于消耗型商品，你需從InAppPurchaseData JSON字串中決議出purchaseToken資訊，用于確認商品的發貨狀態，
在成功發貨并記錄已發貨的商品的purchaseToken之后，你的應用需要使用consumeOwnedPurchase介面消耗該商品，以此通知華為應用內支付服務器更新商品的發貨狀態，發送consumeOwnedPurchase請求時，請在請求引數中攜帶purchaseToken，應用成功執行消耗之后，華為應用內支付服務器會將相應商品重新設定為可購買狀態，用戶即可再次購買該商品，
// 構造ConsumeOwnedPurchaseReq物件 ConsumeOwnedPurchaseReq req = new ConsumeOwnedPurchaseReq(); String purchaseToken = ""; try { // purchaseToken需從購買資訊InAppPurchaseData中獲取 InAppPurchaseData inAppPurchaseDataBean = new InAppPurchaseData(inAppPurchaseData); purchaseToken = inAppPurchaseDataBean.getPurchaseToken(); } catch (JSONException e) { } req.setPurchaseToken(purchaseToken); // 獲取呼叫介面的Activity物件 final Activity activity = getActivity(); // 消耗型商品發貨成功后，需呼叫consumeOwnedPurchase介面進行消耗 Task<ConsumeOwnedPurchaseResult> task = Iap.getIapClient(activity).consumeOwnedPurchase(req); task.addOnSuccessListener(new OnSuccessListener<ConsumeOwnedPurchaseResult>() { @Override public void onSuccess(ConsumeOwnedPurchaseResult result) { // 獲取介面請求結果 } }).addOnFailureListener(new OnFailureListener() { @Override public void onFailure(Exception e) { if (e instanceof IapApiException) { IapApiException apiException = (IapApiException) e; Status status = apiException.getStatus(); int returnCode = apiException.getStatusCode(); } else { // 其他外部錯誤 } } }); - 對于非消耗型商品，華為應用內支付服務器默認回傳已確認的訂單資料，在用戶購買成功之后無需確認交易，您需要在用戶購買成功之后持續向用戶提供相應的商品服務，具體請參見提供非消耗型商品對應的服務，
- 對于訂閱型商品，在用戶購買成功后，無需您額外執行確認交易操作，但需要在訂閱生效期間持續向用戶提供相應的商品服務，具體請參見訂閱專用功能說明-提供商品對應的服務，
2.5 提供非消耗型商品對應的服務
若應用為用戶提供非消耗型商品，可在應用啟動時通過obtainOwnedPurchases介面獲取用戶已購的非消耗型商品的購買資訊，格式請參見InAppPurchaseData，若回傳的購買資訊串列不為空，請確認每個購買資訊的purchaseState欄位，若purchaseState為0，你需提供相應的商品服務，
開發步驟如下：
- 使用obtainOwnedPurchases獲取用戶已購非消耗型商品的資訊，
- 你的應用需要在請求引數OwnedPurchasesReq中指定查詢的priceType為1，
- 你可從回傳的每個商品資訊中決議出purchaseState，用于判斷當前商品的購買狀態，以此作為你的應用的發貨標志，
// 構造一個OwnedPurchasesReq物件
OwnedPurchasesReq ownedPurchasesReq = new OwnedPurchasesReq();
// priceType: 1：非消耗型商品
ownedPurchasesReq.setPriceType(1);
// 獲取呼叫介面的Activity物件
final Activity activity = getActivity();
// 呼叫obtainOwnedPurchases介面
Task<OwnedPurchasesResult> task = Iap.getIapClient(activity).obtainOwnedPurchases(ownedPurchasesReq);
task.addOnSuccessListener(new OnSuccessListener<OwnedPurchasesResult>() {
@Override
public void onSuccess(OwnedPurchasesResult result) {
// 獲取介面請求結果
if (result != null && result.getInAppPurchaseDataList() != null) {
for (int i = 0; i < result.getInAppPurchaseDataList().size(); i++) {
String inAppPurchaseData = result.getInAppPurchaseDataList().get(i);
String inAppSignature = result.getInAppSignature().get(i);
// 您需要使用您的應用的IAP公鑰驗證inAppPurchaseData的簽名
// 如果驗簽成功，請檢查支付狀態
try {
InAppPurchaseData inAppPurchaseDataBean = new InAppPurchaseData(inAppPurchaseData);
int purchaseState = inAppPurchaseDataBean.getPurchaseState();
} catch (JSONException e) {
}
}
}
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof IapApiException) {
IapApiException apiException = (IapApiException) e;
Status status = apiException.getStatus();
int returnCode = apiException.getStatusCode();
} else {
// 其他外部錯誤
}
}
});
3、沙盒測驗：無需真實支付，完成端到端支付測驗
添加商品完畢后，可通過沙盒測驗，在無需真實付款的條件下，進行端到端的支付環節檢測，沙盒測驗步驟如下：
3.1配置沙盒測驗環境
· 設定測驗帳號，
在進行測驗前，需在AppGallery Connect中的用戶與訪問添加測驗帳號，這些測驗帳號都是真實的華為帳號，具體請參見<管理測驗帳號>，
*說明：沙盒測驗帳號添加完成之后需要30min~1h才能生效，使用時請檢查當前的帳號是否支持沙盒測驗，
· 配置沙盒測驗版本，
如果要測驗的應用包此前沒有在AGC上架過版本，只需要確保測驗包的versionCode大于0；如果已有上架的版本，則測驗包的versionCode需要大于上架版本的versionCode，
3.2測驗非訂閱型商品支付
可在設備上登錄已配置的測驗帳號，并安裝該待測驗應用，發起非訂閱型商品購買時，華為IAP會檢測到該用戶為測驗用戶，跳過實際支付環節，直接支付成功，
效果示例如下：
3.3測驗訂閱型商品續訂
訂閱型商品的購買流程和普通商品(非訂閱)的購買流程類似，但訂閱還有其他細節場景，比如續訂成功或失敗，續訂周期時長，為了幫助開發者快速測驗應用的訂閱場景，沙盒環境下的訂閱續訂時間會比正常情況更快，引入“時光機”概念，
時光機：僅針對訂閱型商品的續期時間，不影響訂閱型商品的生效時間（比如訂閱周期為1周，商品在3分鐘后發生續期，此時訂閱型商品有效期延長了1周），
效果示例如下：
完成以上步驟，你就順利搞定應用內商品創建和測驗上架，商品管理環節，商品資訊修改、失效激活商品、洗掉商品等操作步驟，我們下期繼續，
華為應用內支付還提供了“零掉單”的訂單管理、提營收增長的增強型訂閱服務等能力，我們也會在后期為大家推送超細詳解，敬請期待哦~
>>了解更多詳情，請戳：
華為應用內支付服務官網
華為應用內支付服務開發指導檔案
>>華為HMS Core官方社區
>>華為移動服務開源倉庫地址：GitHub、Gitee
關注我們，第一時間了解華為移動服務最新技術資訊~
轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/275880.html
標籤：其他
上一篇：基于Canvas的九宮格抽獎，就是仿csdn的APP做的，能過審不？
下一篇：STL基本概念