XGサブスクリプション通知受信シーケンス¶

XGサブスクリプション通知受信シーケンスは、XGからゲームサーバーに送信されるサブスクリプション状態の変更通知（購入、継続、キャンセル、返金など）を受信・処理するフローです。

XGはゲームサーバーに通知を送信し、ゲームサーバーは利用権の付与・無効化・回収などの処理を行います。購入・継続の通知が正常に処理された場合、XGはゲーム内通貨の発行も行います。

XGサブスクリプション通知受信 ¶

XGからのXGサブスクリプション通知を受信し、サブスクリプションの情報を保存するフローです。

このシーケンスは以下のシーケンスから呼び出されます：

XGサブスクリプション通知の受信に失敗した場合や、XGがレスポンスを受け取れなかった場合、受信後のXGの処理でエラーが生じた場合にはリカバリー処理が必要です。

イベントごとのサブスクリプション状態と利用権処理の対応は XGサブスクリプション通知のサブスクリプション状態変更イベントと利用権処理を参照してください。

ゲームサーバーが保存すべき主要な項目¶
項目	値の例	説明
transactionId	12345678-1234-5678-9abc-abcdef000001	XGが発行した取引ID。処理済み判定に使用
renewalTransactionId	2000000012345679	ストアが発行した取引ID。付与したアイテムと紐づけて保存し、回収時に対象を特定するために使用
planId	appstore01_monthly	プランID。月額、年額などの識別に利用
groupId	sub-product0001	サブスクリプショングループID
event	renewal	サブスクリプションのイベント。アイテム付与などの判定に使用
subscriptionStatus	active	サブスクリプション状態。サブスクリプションが有効かどうかの判定に利用
subscriptionExpiryAt	2026-01-08T00:00:00Z	サブスクリプションの有効期限。ゲーム端末での表示に利用
ゲーム端末表示フラグ	未表示 / 表示済み	ゲーム端末に結果を表示したかどうか。ゲームサーバー側で管理

XGサブスクリプション通知の処理方法は以下の2種類があります。

ゲーム端末からのログイン時などに、未処理のXGサブスクリプション通知を確認して処理するフローです。

バッチ処理を待たずに、ユーザーのゲームプレイ時に先行して処理を行います。

XGのバッチ処理で、未処理のXGサブスクリプション通知を定期的に処理するフローです。