我們的服務器需要提供一個URL來接收蘋果的通知纹腌,要使用HTTPS苟弛。
蘋果會對這個URL發(fā)送HTTP POST請求软棺,body是JSON格式,包含了通知的內(nèi)容影涉。
我們服務器處理成功后变隔,應向蘋果返回HTTP 200。若出現(xiàn)問題蟹倾,需要蘋果重新發(fā)送通知匣缘,可返回HTTP 50x 或 40x。
environment字段表示通知對應的環(huán)境喊式。若為Sandbox孵户,表示測試環(huán)境,PROD表示生產(chǎn)環(huán)境岔留。
unified_receipt 字段中包含了最近的交易信息夏哭。可通過其中的original_transaction_id找到對應原始訂閱献联。
notification_type 表示觸發(fā)此通知的事件類型竖配。其值如下:
CANCEL:表示用戶退款了何址,或者用戶升級了訂閱。(用戶升級訂閱后进胯,會退款之前的訂閱)
DID_CHANGE_RENEWAL_PREF:表示用戶更改訂閱計劃用爪,會在下次訂閱生效。對當前訂閱無影響胁镐。
DID_CHANGE_RENEWAL_STATUS:表示續(xù)訂狀態(tài)有改變偎血。可檢查auto_renew_status_change_date_ms和auto_renew_status字段盯漂。
DID_FAIL_TO_RENEW:表示由于賬單問題颇玷,續(xù)訂失敗【屠拢可檢查is_in_billing_retry_period
DID_RECOVER:表示成功續(xù)訂帖渠。這個是針對過去續(xù)訂失敗的訂閱。
INITIAL_BUY:表示第一次訂閱竭宰。
INTERACTIVE_RENEWAL:表示用戶手動續(xù)訂成功空郊。
RENEWAL:表示自動續(xù)訂成功。(此字段蘋果計劃廢棄切揭,用DID_RECOVER代替狞甚。)
下面是常見的事件和觸發(fā)的通知
首次購買:INITIAL_BUY
升級訂閱:CANCEL, DID_CHANGE_RENEWAL_STATUS, INTERACTIVE_RENEWAL
降級訂閱:INTERACTIVE_RENEWAL, DID_CHANGE_RENEWAL_PREF
訂閱已過期,重新訂閱:DID_CHANGE_RENEWAL_STATUS
訂閱已過期伴箩,重新升級或降級訂閱:INTERACTIVE_RENEWAL, DID_CHANGE_RENEWAL_STATUS
用戶取消訂閱:DID_CHANGE_RENEWAL_STATUS
用戶退款:CANCEL, DID_CHANGE_RENEWAL_STATUS
由于賬單問題入愧,續(xù)訂失敱陕:DID_FAIL_TO_RENEW
賬單問題解決嗤谚,續(xù)訂成功:DID_RECOVER
由于賬單問題,訂閱被徹底取消:DID_CHANGE_RENEWAL_STATUS
官方文檔:https://developer.apple.com/documentation/storekit/in-app_purchase/enabling_server-to-server_notifications
例子
{
? "latest_receipt": "***",
? "latest_receipt_info": {
? ? "original_purchase_date_pst": "2020-03-23 21:12:34 America/Los_Angeles",
? ? "quantity": "1",
? ? "subscription_group_identifier": "***",
? ? "unique_vendor_identifier": "***",
? ? "original_purchase_date_ms": "1585023154000",
? ? "expires_date_formatted": "2020-04-24 04:12:33 Etc/GMT",
? ? "is_in_intro_offer_period": "false",
? ? "purchase_date_ms": "1585023153000",
? ? "expires_date_formatted_pst": "2020-04-23 21:12:33 America/Los_Angeles",
? ? "is_trial_period": "false",
? ? "item_id": "***",
? ? "unique_identifier": "***",
? ? "original_transaction_id": "***",
? ? "expires_date": "1587701553000",
? ? "app_item_id": "***",
? ? "transaction_id": "***",
? ? "bvrs": "12",
? ? "web_order_line_item_id": "***",
? ? "version_external_identifier": "***",
? ? "bid": "***",
? ? "product_id": "***",
? ? "purchase_date": "2020-03-24 04:12:33 Etc/GMT",
? ? "purchase_date_pst": "2020-03-23 21:12:33 America/Los_Angeles",
? ? "original_purchase_date": "2020-03-24 04:12:34 Etc/GMT"
? },
? "environment": "PROD",
? "auto_renew_status": "true",
? "unified_receipt": {
? ? "latest_receipt": "***",
? ? "pending_renewal_info": [
? ? ? {
? ? ? ? "original_transaction_id": "***",
? ? ? ? "product_id": "***",
? ? ? ? "auto_renew_status": "1",
? ? ? ? "auto_renew_product_id": "***"
? ? ? }
? ? ],
? ? "environment": "Production",
? ? "status": 0,
? ? "latest_receipt_info": [
? ? ? {
? ? ? ? "expires_date_pst": "2020-04-23 21:12:33 America/Los_Angeles",
? ? ? ? "purchase_date": "2020-03-24 04:12:33 Etc/GMT",
? ? ? ? "purchase_date_ms": "1585023153000",
? ? ? ? "original_purchase_date_ms": "1585023154000",
? ? ? ? "transaction_id": "***",
? ? ? ? "original_transaction_id": "110000712466308",
? ? ? ? "quantity": "1",
? ? ? ? "expires_date_ms": "1587701553000",
? ? ? ? "original_purchase_date_pst": "2020-03-23 21:12:34 America/Los_Angeles",
? ? ? ? "product_id": "***",
? ? ? ? "subscription_group_identifier": "***",
? ? ? ? "web_order_line_item_id": "***",
? ? ? ? "expires_date": "2020-04-24 04:12:33 Etc/GMT",
? ? ? ? "is_in_intro_offer_period": "false",
? ? ? ? "original_purchase_date": "2020-03-24 04:12:34 Etc/GMT",
? ? ? ? "purchase_date_pst": "2020-03-23 21:12:33 America/Los_Angeles",
? ? ? ? "is_trial_period": "false"
? ? ? }
? ? ]
? },
? "password": "***",
? "auto_renew_product_id": "***",
? "notification_type": "INITIAL_BUY"
}