Web Service Endpoint


消費情報を送信


あなたのサーバーが消費要求通知を受信した後、消耗品のアプリ内購入または自動更新サブスクリプションに関する消費情報を App Store に送信します。


App Store Server API 1.0+



URL


PUT https://api.storekit.itunes.apple.com/inApps/v1/transactions/consumption/{transactionId}


Sandbox URL


PUT https://api.storekit-sandbox.itunes.apple.com/inApps/v1/transactions/consumption/{transactionId}


パスパラメータ


transactionId
transactionId		(必須) 消費情報を提供する取引 ID。この ID は、App Store からあなたのサーバーの App Store Server Notifications V2 エンドポイントに送信される CONSUMPTION_REQUEST 通知で受信されます。

HTTP 本体


ConsumptionRequest要求本体。
Content-Type: application/json

反応コード


202承認した
App Store サーバーは消費情報を受信しました。
400
(InvalidAccountTenure
Error | InvalidApp
AccountTokenError | InvalidConsumptionStatus
Error | InvalidCustomer
ConsentedError | Invalid
DeliveryStatusError | InvalidLifetimeDollars
PurchasedError | Invalid
LifetimeDollarsRefunded
Error | InvalidPlatform
Error | InvalidPlayTime
Error | InvalidSample
ContentProvidedError | InvalidUserStatusError | InvalidRefundPreference
Error | Invalid
TransactionTypeNot
SupportedError)		不正な要求です。
無効な要求です。詳細はエラーコードをご覧ください。エラーコードがない場合、要求の形式が不正です。
Content-Type: application/json
401



未承認
承認ヘッダー内の JSON Web トークン (JWT) が無効です。詳細については、API 要求用の JSON Web トークンの生成 を参照してください。
404
TransactionIdNotFound
Error)		見つからない
取引 ID が見つかりませんでした
Content-Type: application/json
429
RateLimitExceededError		要求がレート制限を超えました。
Content-Type: application/json
500
GeneralInternalError		内部サーバのエラー
サーバーのエラーです。後で再度試して下さい。
Content-Type: application/json


以下で言及


App Store サーバ API の変更履歴


レート制限の識別



議論


App Store は、払い戻し要求の承認または却下を決定する際に、様々な要素を考慮します。払い戻しプロセスの改善と情報提供に役立てるため、ユーザーが払い戻しを要求した際に、App 内課金アイテムの消費に関する情報を App Store に送信することができます。App Store は、提供された消費情報に基づいて払い戻しの判断を行います。


顧客が消耗品のアプリ内購入または自動更新サブスクリプションの払い戻し要求を開始すると、App Store は App Store Server Notifications V2 エンドポイントを通じて CONSUMPTION_REQUEST notificationType をあなたのサーバーに送信します。顧客が同意した場合は、この API を呼び出して ConsumptionRequest の消費データを App Store に送信することで応答します。同意しない場合は、CONSUMPTION_REQUEST 通知に応答しないでください。


CONSUMPTION_REQUEST 通知を受信してから 12 時間以内に応答してください。


App Store サーバー通知を受信するためのあなたのサーバー設定については、App Store サーバー通知の有効化 をご覧ください。アプリ内で払い戻し要求を開始する方法については、beginRefundRequest(in:)、beginRefundRequest(for:in:)、beginRefundRequest(in:)、beginRefundRequest(for:in:) などの払い戻し要求メソッドをご覧ください。



有効な同意を得る


消費情報を送信 API でユーザーの個人データを Apple と共有する前に、有効な同意を取得しなければなりません。ユーザーから収集したデータを Apple と共有するため、有効な同意を取得する責任は開発者のみにあります。


有効な同意を取得するための要件は適用する法律によって異なるため、Apple は有効な同意を取得する具体的な方法についてアドバイスすることはできません。適用する法律への具体的な準拠状況を判断するのは開発者の責任です。あなたのアプリが Apple のガイドラインに違反している場合、App Review が連絡し、懸念事項への対応について協力いたします。


有効な同意を得るために留意すべき一般的なガイドラインを以下に示します。


  • 有効な同意とは、ユーザーの個人データに関する希望と尊敬について、自由意志に基づき、具体的かつ十分な情報に基づいた明確な同意を指します。

  • 例えば、同意を求める際には、次のような内容を含めることが考えられます。ユーザーのアプリ払い戻し要求の審査を支援するために、Apple に個人データの一部を提供することをユーザーに明確に伝える文言、ユーザーがいつでも同意を撤回できることを明確に伝える文言、そしてユーザーが同意を表明する方法。

  • オプトインによる同意は、オプトアウトによる同意よりも高い基準で認められます。一般的に、個人にオプトアウトの機会を提供しない場合、同意が自由意志に基づいて与えられたことを示すことが困難になる可能性があります。

  • 同意を得た後、状況の変化によりユーザーの同意が有効でなくなったと判断された場合（例えば、データの使用方法や共有方法の変更、またはユーザーがこの目的のために同意を撤回した場合など）、customerConsented フラグを更新し、そのユーザーからのデータを送信しないでください。

    • 重要

    消費情報を送信 API を通じて Apple とデータを共有することへの同意を得るために App Tracking Transparency のプロンプトを使用しないでください。消費情報を送信 エンドポイントの使用に必要な同意の取得は、App Tracking Transparency とは無関係です。これら 2 つの機能はそれぞれ異なるものであり、関連性はありません。

    消費情報を送信 API を通じて Apple と共有するデータは、トラッキング (追跡) には使用されません。消費情報を送信 API を使用して Apple とデータを共有する場合は、ユーザーから別途あなたが同意を得る必要があります。



    データ使用を公開する


    消費情報を送信 APIを導入する場合は、アプリのプライバシーに関する質問に回答し、あなたのユーザーから収集するデータとその使用目的をラベルに明記してください。アプリのプライバシーラベルに関する詳細は、App Store のアプリのプライバシー詳細 をご覧ください。


    Apple は、消費情報を送信 API を通じてあなたが共有するデータを、Apple のプライバシーポリシー に従って使用し保護します。Apple によるデータ保護方法について詳しくは、Apple プラットフォームセキュリティガイド を参照してください。Apple は、消費情報を送信 API を通じてあなたが提供したデータを、データ収集目的の達成に必要な期間保持します。この目的とは、顧客の返金要求の審査に役立つデータを取得することで、返金プロセスを改善することです。Apple は、消費情報を送信 API を通じてあなたが提供したデータを、Apple に代わって活動するサービスプロバイダ、Apple のパートナー、またはあなたの指示を受けたその他の者と共有する場合があります。Apple は、第三者が独自のマーケティング目的でデータを共有することはありません。詳しくは、App Store とプライバシー を参照してください。



    消費データへのアクセスと削除要求への対応


    あなたのユーザーが消費情報に関連する個人データへのアクセスまたは削除を要求する場合は、privacy.apple.com にアクセスして Apple に直接要求を送信できることをユーザーに伝えてください。あなたのアプリがあなたのユーザーに代わって CloudKit にデータを保存する場合は、データ削除要求への対応、CloudKit データへのユーザーアクセスの提供、ユーザーデータへのアクセス制御の変更 をご覧ください。




    以下も見よ


    消費情報


    object ConsumptionRequest

    消費情報を含む要求本体。














    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ