Web Service Endpoint


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

  廃止  

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


App Store Server API 1.1-1.6+   廃止  

廃止

代わりに 払い戻し履歴の取得 を使用してください。




URL


GET https://api.storekit.itunes.apple.com/inApps/v1/refund/lookup/{originalTransactionId}

サンドボックス URL


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


パスパラメータ


originalTransactionId
originalTransactionId		(必須)顧客に属する取引の元の取引 ID。

反応コード


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



未承認
承認ヘッダー内の JSON Web トークン (JWT) が無効です。詳細については、API 要求用の JSON Web トークンの生成 を参照してください。
404
OriginalTransactionIdNot
FoundError		見つかりません
要求は無効です。詳細については、特定のエラーメッセージを確認してください。
Content-Type: application/json
429
RateLimitExceededError		要求がレート制限を超えました。
Content-Type: application/json
500
(GeneralInternalError | GeneralInternal
RetryableError)		内部サーバのエラー
要求が失敗しました。一時的な障害が原因である可能性があります。詳細については、特定のエラーメッセージをご確認ください。
Content-Type: application/json


以下で言及


App Store サーバ API の変更履歴


レート制限の識別



議論


このエンドポイントを呼び出すと、あなたのアプリの顧客の払い戻し履歴を取得できます。応答 (RefundLookupResponse) には、revocationDate に基づいて、顧客の最新の払い戻し取引が最大 50 件含まれます。


注意

完全な払い戻し履歴を取得するには、払い戻し履歴の取得 を使用します。


このエンドポイントを呼び出すには、顧客のアプリ内購入のいずれかの元の取引 ID（originalID）を提供してください。応答には、消耗型、非消耗型、自動更新サブスクリプション、非更新サブスクリプションなど、あらゆる型の製品について、App Store で承認された払い戻しのみが含まれます。製品の型の詳細については、アプリ内購入 をご覧ください。


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


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


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




以下も見よ


払い戻しの検索


払い戻し履歴の取得

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


object RefundHistoryResponse

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