actor フィールドが追加サブスクリプションの課金・契約編集・ステータス変更を「誰が起点で行ったか」（顧客 / マーチャント / パートナーアプリ）を、mutation 実行時に記録できるようになった。
actor 引数が新設された。課金作成や契約変更は記録されるが、その操作を 誰が起点で発火させたか はミューテーションの引数として標準化されていなかった。
actor に customer / merchant / partner を指定して、操作の発生源を明示できるようになった。
買い手がアクションを開始した場合。例 ： カスタマーポータルで「今すぐ支払う（pay now）」をクリックした、など。
マーチャントまたはそのスタッフが手動でアクションを開始した場合。
パートナーアプリの自動システムが開始した場合。例 ： スケジュール課金やリトライ（再試行）ロジック、など。
subscriptionBillingAttemptCreate だけは subscriptionBillingAttemptInput.actor として入力オブジェクト経由で渡す、と記事に明記されている。それ以外は mutation の引数として actor を含める。記事に列挙されている対応ミューテーションは、用途別に次の3グループ。
| グループ | 対応ミューテーション |
|---|---|
| 課金試行 Billing Attempts |
subscriptionBillingAttemptCreate（subscriptionBillingAttemptInput.actor 経由）subscriptionBillingCycleChargesubscriptionBillingCycleBulkCharge
|
| 契約編集 Contract Edits |
subscriptionContractCreatesubscriptionContractUpdatesubscriptionContractAtomicCreatesubscriptionContractProductChangesubscriptionBillingCycleContractEdit
|
| ステータス更新 Status Updates |
subscriptionContractActivatesubscriptionContractPausesubscriptionContractCancelsubscriptionContractFailsubscriptionContractExpire
|
・actor 引数の新設と目的（誰が起点かの追跡）
・取りうる3つの値（customer / merchant / partner）と各例
・対応する13個のミューテーション（3グループ）
・subscriptionBillingAttemptCreate のみ入力オブジェクト経由
・API バージョンタグ ： 2026-07
・actor が必須か任意か、デフォルト値 → 記載なし
・未指定時の挙動 → 記載なし
・記録された actor の読み取り（クエリ）方法 → 記載なし
・利用に必要なアクセススコープ / 権限 → 記載なし
・actor が認証主体と一致するかの検証可否 → 記載なし
2026-07）のスキーマ／ドキュメントで確認すること。受け付けるのは customer / merchant / partner の3値のみ。送信側でこのいずれかを正しくマッピングして渡す設計が必要。
subscriptionBillingAttemptCreate は引数直下ではなく subscriptionBillingAttemptInput.actor に入れる。共通化したクライアント実装では分岐が要る。
課金・契約編集・ステータス更新の13ミューテーションに渡る。自前のサブスク連携コードで、呼び出し箇所すべてに actor 設定方針を通すのが望ましい。
記事に必須かどうか・デフォルト・未指定時の挙動の記載はない。サンドボックスで実挙動を確認してから本番ロジックを固めること。
2026-07 の機能 ／ 価値は「分析・監査」軸記事のタグは 2026-07。actor は決済そのものを変える機能ではなく、「誰が起点でそのサブスク操作を発火させたか」を構造化メタデータとして残すもの。チャーン分析・監査ログ・自動 vs 手動の切り分けに効く。記録値の読み取り方法は記事に記載がないため別途確認が必要。
actor を必ず付与し、customer / merchant / partner 別に解約・失敗を集計する。actor の読み取り方法は記事に記載なし。集計前に対象 API バージョンで取得手段（クエリ）を確認すること。actor を付け、操作の起点を構造化メタデータとして残す。customer、管理画面のスタッフ操作は merchant、バックエンドの自動処理は partner をマッピングする実装方針を統一する。subscriptionBillingAttemptCreate など）には partner を付与し、顧客の「今すぐ支払う」は customer として分離記録する。subscriptionBillingAttemptCreate は subscriptionBillingAttemptInput.actor 経由で渡す点に注意。スケジューラ／リトライ経路のコードに固定で partner を埋め込む。actor フィールドが追加（API 2026-07）。