Web Service Endpoint


払い戻し履歴の取得 (Get Refund History)


顧客のアプリ内購入のうち払い戻しを受けたものすべてをページ分けしたリストを取得します。


App Store Server API 1.6+



URL


GET https://api.storekit.itunes.apple.com/inApps/v2/refund/lookup/{transactionId}

サンドボックス URL


GET https://api.storekit-sandbox.itunes.apple.com/inApps/v2/refund/lookup/{transactionId}


パスパラメータ


transactionId
transactionId		(必須)顧客に属する取引の ID。元の取引 ID (originalTransactionId) である場合があります。

クエリパラメータ


revision
revision		次の最大 20 件の取引セットを取得するためのトークンです。すべての応答には revision トークンが含まれます。前回の RefundHistoryResponse の revision トークンを使用してください。
最終結果ページの revision トークンを保存し、将来の呼び出しで使用できます。詳細については、RefundHistoryResponse をご覧ください。
revision トークンは、最初の要求を除くすべての要求で必須です。

反応コード


200
RefundHistoryResponse		OK
要求は成功した。
Content-Type: application/json
400
(InvalidTransactionId
Error | InvalidRequest
RevisionError)		不正な要求です。
要求は無効です。詳細については、特定のエラーメッセージを確認してください。
Content-Type: application/json
401



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


以下で言及


App Store サーバ API の変更履歴


レート制限の識別



議論


このエンドポイントを呼び出すと、顧客のアプリ内購入の取引 ID (transactionId) を指定して、あなたのアプリの払い戻し履歴をすべて取得できます。各応答 (RefundHistoryResponse) には、最大 20 件の払い戻し済み取引が含まれます。応答の hasMore プロパティが true の場合、応答の revision トークンを使用してエンドポイントを再度呼び出し、次の払い戻し済み取引セットを取得します。


応答には、消耗型、非消耗型、自動更新サブスクリプション、非更新サブスクリプションなど、あらゆる型の製品について、App Store が承認した払い戻しのみが含まれます。製品の型の詳細については、アプリ内購入 をご覧ください。


応答内の情報は、App Store サーバ通知 からの 1 つ以上の REFUND 通知 (notificationType) の情報と同じです。この API を使用すると、サーバー障害時などにあなたが見逃した可能性のある払い戻し通知を取得できます。


顧客が App Store で承認された払い戻しを受けていない場合、成功した応答の signedTransactions 配列は空になります。払い戻しの日付と理由コードを確認するには、JWSTransactionDecodedPayload の revocationDate と revocationReason を参照してください。


App Store Server API は、顧客がデバイスにアプリをインストール、削除、または再インストールしたかどうかに関係なく、顧客のアプリ内購入履歴に基づいて情報を返します。


あなたのアプリの顧客の払い戻し履歴全体を取得するには、まず以下のようにクエリパラメータを指定せずにエンドポイントを呼び出します。


GET https://api.storekit.itunes.apple.com/inApps/v2/refund/lookup/{transactionId}

後続の要求では、以前の RefundHistoryResponse の revision トークンを含めます。


GET https://api.storekit.itunes.apple.com/inApps/v2/refund/lookup/{transactionId}?revision={revision}



以下も見よ


払い戻しの検索


object RefundHistoryResponse

署名された JSON Web 署名 (JWS) 払い戻し取引の配列とページング情報を含む応答。


払い戻し履歴の取得 V1

顧客があなたのアプリ内で払い戻した購入のリストを最大 50 件取得します。

  廃止  


object RefundLookupResponse

署名された JSON Web Signature (JWS) 取引の配列を含む応答。

  廃止  














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ