取引終了通知Webhook


商品の出品または取引が終了したことをゲーム側に通知します。
出品ユーザがゲーオクConnect内で出品終了操作を行った場合、出品期限内に落札が成立しなかった場合、または落札後期限内に支払いが行われなかった場合に発生します。
このWebhookが発行された場合は、対象商品を出品ユーザの所持へ戻す必要があります。
ゲーム側での実装は必須になります。


Webhook発行契機

以下のいずれかを契機とします。
(1)出品者がゲーオクConnect内で出品を終了させた場合。
(2)出品期限内に落札が無かった場合。
(3)落札後、落札者が支払期限内に支払いを行わなかった場合。


送信先URL

ゲーム側指定の取引終了通知用URL


送信方式

POST送信(URLエンコード)


送信パラメータ

パラメータ名 設定する内容
type 数値 取引が終了した契機
 1:出品者がゲーオクConnect内で出品を終了させた
 2:出品期限内に落札が無かった
 3:落札後、落札者が支払期限内に支払いを行わなかった
itemid 数値 商品ID
author 文字 出品者ID(11桁)
payer 文字 落札者ID(11桁、入札があった場合のみ)
apitime 文字 Webhook実行サーバ時間(YYYY/MM/DD HH:MM:SS +0000 の形式)

▼送信値サンプル

				type=3
				&itemid=123
				&author=12345678901
				&payer=23456789012
				&apitime=2015%2F08%2F15+10%3A24%3A46+%2B0900
			

送信時認証方法

署名認証
※認証についてはAPI/Webhookについてをご参照ください。


Webhook受信時のゲーム側での処理

出品時に凍結させていた出品者の商品を出品者へ戻します。


戻り値形式

JSON


戻り値パラメータ

キー名 設定される内容
rcode 実行結果
 0:成功
 -1:失敗

備考

発行したWebhookに対し成功の戻り値(rcode=0)が無かった場合、最大2回まで、60秒後に再度Webhookを発行する。
ゲーム側で出品終了した場合(「出品取消」APIを使用した場合)は、本Webhookは発行しない。
その場合は、ゲーム側で出品終了すると同時に、出品時に凍結させていた出品者の商品を出品者へ戻すこと。