IAP 促銷優惠后端接入指南

• 前言
• • 使用場景
  • 接入流程
  • • 1. 后臺配置
    • 2. 判斷用戶是否可以使用促銷優惠
    • 3. 生成簽名
    • 4. 解析優惠字段

前言

促銷優惠是 iOS12.2新增的針對 IAP 自動續期訂閱類型產品更加靈活的促銷方式, 整體流程如下圖, 官方文檔見 https://developer.apple.com/documentation/storekit/in-app_purchase/implementing_subscription_offers_in_your_app?language=objc


那我們的server需要做什么呢?
1.判斷用戶是否可以使用優惠
2.對參數進行簽名
3.解析收據中促銷優惠相關字段

使用場景

我們的場景是一個連包會員業務, ios端使用iap的自動續期訂閱類型

接入流程

1. 后臺配置

配置主要分為兩步
1.登陸app store connect, 找到「用戶和訪問」->「密鑰」->「訂閱」, 點擊+號, 創建完成后, 點擊下載密鑰文件(是一個采用ECC算法的私鑰文件), 這個文件只能下載一次, 一定要保存好, 并且不要隨意泄漏給其他人. 這里的 密鑰ID 后面流程會用到

2.登陸app store connect, 找到 「我的app」 -> 「功能」-> 「你們的訂閱商品」-> 「訂閱價格」, 點擊 + 號, 選擇 創建促銷優惠, 這時需要設置我們的優惠名稱, 優惠代碼(該字段在后續流程會用到), 點擊下一步后, 創建優惠價格

2. 判斷用戶是否可以使用促銷優惠

這個就是具體的業務邏輯了, 蘋果支持 當前正在訂閱中 以及 已經過期的訂閱 使用促銷優惠, 但是要注意一點, 第一次購買app下的訂閱商品時不能使用促銷優惠, 客戶端調用促銷優惠相關邏輯時會報錯, 這種case 我們的處理方案是, 客戶端解析到該異常, 傳遞一個重試標記, 服務端記錄重試標記, 當標記存在時不返回優惠, 任意一筆訂閱交易成功后刪除標記.

3. 生成簽名

簽名的生成規則 https://developer.apple.com/documentation/storekit/in-app_purchase/generating_a_signature_for_subscription_offers?language=objc
簽名字段如下

字段名來源

appBundleID	值為 app store connect中「我的APP」-> 「APP信息」->「綜合信息」->「套裝ID」
keyIdentifier	后臺配置第一步中的密鑰ID
productIdentifier	后臺配置的商品code
offerIdentifier	后臺配置第二步中的優惠產品code(需要根據業務場景具體選擇一個優惠產品code)
applicationUsername	依賴客戶端具體的使用, 需要跟客戶端確認
nonce	UUID, 一定要滿足UUID的標準格式, 不然會報錯, 服務端是java的話可以使用java.util.UUID.randomUUID().toString()
timestamp	時間戳

注意!
蘋果使用的加密算法為ECC, 服務端是java的話, 簽名時使用
KeyFactory.getInstance(“ec”);
Signature.getInstance(“SHA256WithECDSA”);
其余簽名代碼省略, 請讀者自行查找

4. 解析優惠字段

當用戶使用促銷優惠支付后, 收據in_app和latest_receipt_info 中會出現 promotional_offer_id 字段, 值為使用當優惠的code

總結

以上是生活随笔為你收集整理的IAP 促销优惠(promotional offer)后端接入指南的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。