Web Service Endpoint

サブスクリプション更新日を延長する

元の取引 ID を使用して、顧客のアクティブなサブスクリプションの更新日を延長します。

App Store Server API 1.1+

URL

PUT https://api.storekit.itunes.apple.com/inApps/v1/subscriptions/extend/{originalTransactionId}

Sandbox URL

PUT https://api.storekit-sandbox.itunes.apple.com/inApps/v1/subscriptions/extend/{originalTransactionId}

パスパラメータ

originalTransactionId
originalTransactionId

(必須)更新日延長を受け取るサブスクリプションの元の取引 ID。

HTTP 本体

ExtendRenewalDate Request	サブスクリプション更新延長データを含む要求本文。 Content-Type: application/json
400 (InvalidOriginal TransactionIdError \| InvalidExtendByDays Error \| InvalidExtend ReasonCodeError \| InvalidRequest IdentifierError)	不正な要求要求は無効であり、受け付けられません。 Content-Type: application/json
401	不正認証ヘッダ内の JSON Web Token（JWT）が無効です。詳しくは、API 要求用の JSON Web トークンの生成をご覧ください。
403 (SubscriptionExtension IneligibleError \| SubscriptionMax ExtensionError \| Family SharedSubscription ExtensionIneligible Error)	禁止要求は無効であり、受け付けられません。 Content-Type: application/json
404 OriginalTransactionId NotFoundError	見つからない要求は無効であり、受け付けられません。 Content-Type: application/json
429 RateLimitExceededError	要求がレート制限を超えました。 Content-Type: application/json
500 (GeneralInternalError \| GeneralInternal RetryableError)	内部サーバーエラー要求が失敗しました。一時的な障害が原因である可能性があります。詳細については、特定のエラーメッセージをご確認ください。 Content-Type: application/json

以下で言及

自動更新サブスクリプションの更新日を延長

App Store サーバ API の変更履歴

レート制限の識別

議論

このエンドポイントを使用すると、一時的なサービス停止、イベントのキャンセル、ライブストリーミングイベントの中断などが発生した場合に、顧客達の有料のアクティブなサブスクリプションの更新日を延長することで補償することができます。このエンドポイントは、あなたが指定した取引 ID の単一のサブスクリプションに対して機能します。

このエンドポイントを呼び出すには、サービス中断が発生したサブスクリプションの元の取引 ID を指定してください。要求本体（ExtendRenewalDateRequest）には、延長期間、延長理由コード、および各延長要求の一意の requestIdentifier を指定してください。

このエンドポイントが家族間共有に対応する購入済みのサブスクリプションを延長すると、家族メンバーのサブスクリプションも自動的に延長されます。ただし、このエンドポイントは家族メンバーのサブスクリプションを直接延長する要求をサポートしていません。

HTTP 200 ステータスコードで成功した応答には、ExtendRenewalDateResponse オブジェクトが含まれます。応答オブジェクトには、要求であなたが指定したのと同じ一意の要求 ID と、延長が成功したかどうかを判断するために必要な情報が含まれます。延長が成功した場合、新しいサブスクリプションの有効期限は effectiveDate になります。HTTP 200 以外の全てのステータスコードは、要求が失敗したことを示します。