我們的服務(wù)器需要提供一個URL來接收蘋果的通知,要使用HTTPS。
蘋果會對這個URL發(fā)送HTTP POST請求,body是JSON格式,包含了通知的內(nèi)容。
我們服務(wù)器處理成功后,應(yīng)向蘋果返回HTTP 200。若出現(xiàn)問題,需要蘋果重新發(fā)送通知,可返回HTTP 50x 或 40x。
environment字段表示通知對應(yīng)的環(huán)境。若為Sandbox,表示測試環(huán)境,PROD表示生產(chǎn)環(huán)境。
unified_receipt 字段中包含了最近的交易信息??赏ㄟ^其中的original_transaction_id找到對應(yīng)原始訂閱。
notification_type 表示觸發(fā)此通知的事件類型。其值如下:
CANCEL:表示用戶退款了,或者用戶升級了訂閱。(用戶升級訂閱后,會退款之前的訂閱)
DID_CHANGE_RENEWAL_PREF:表示用戶更改訂閱計劃,會在下次訂閱生效。對當前訂閱無影響。
DID_CHANGE_RENEWAL_STATUS:表示續(xù)訂狀態(tài)有改變??蓹z查auto_renew_status_change_date_ms和auto_renew_status字段。
DID_FAIL_TO_RENEW:表示由于賬單問題,續(xù)訂失敗??蓹z查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ù)訂失?。篋ID_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"
}