gpc-purchase-orders

購入と注文

購入の検証、サブスクリプションの状態確認、返金処理、外部取引の管理を行う際に、このスキルを使用します。

購入の検証

購入を検証する

gpc purchases verify --product-id premium_upgrade --token PURCHASE_TOKEN --package com.example.app

サブスクリプションの状態を確認する

gpc purchases subscription-status --product-id monthly_pro --token PURCHASE_TOKEN --package com.example.app

購入を承認する

gpc purchases acknowledge --product-id premium_upgrade --token PURCHASE_TOKEN --package com.example.app

無効化された購入

無効化された購入を一覧表示する

gpc purchases voided list --package com.example.app

注文

注文の詳細を取得する

gpc orders get --order-id GPA.1234-5678-9012 --package com.example.app

複数の注文を取得する

gpc orders batch-get --order-ids GPA.1234-5678-9012,GPA.9876-5432-1098 --package com.example.app

注文を返金する

gpc orders refund --order-id GPA.1234-5678-9012 --confirm --package com.example.app

外部取引（代替課金）

外部取引を作成する

gpc ext-tx create --file transaction.json --package com.example.app

外部取引を取得する

gpc ext-tx get --name transactions/12345 --package com.example.app

外部取引を返金する

gpc ext-tx refund --name transactions/12345 --confirm --package com.example.app

エージェントの動作

• 操作を実行する前に、必ず購入トークンの有効性を確認してください。
• 返金には --confirm を必須とし、自動で確定しないでください。
• 返金を処理する前に、注文の詳細を表示してください。
• gpc orders refund の前に gpc orders get を使って確認してください。

メモ

• 購入トークンは、クライアントアプリの課金ライブラリから取得します。
• 無効化された購入には、返金、チャージバック、取り消しが含まれます。
• 外部取引は、代替課金を使用するアプリ向けです（登録が必要です）。
• ext-tx は external-transactions の短縮エイリアスです。