subscriptionBillingAttemptCreate に新フィールド paymentProcessingPolicy が追加。有効な支払い方法が無くても、注文を「未払い」のまま作成できる選択肢が増えた。
paymentProcessingPolicy。
課金試行で注文を成立させるには、契約に有効な支払い方法がある前提。無ければ注文は作れなかった。
paymentProcessingPolicy に SKIP_PAYMENT_AND_CREATE_UNPAID_ORDER を指定すると、有効な支払い方法が無くても未払い注文を作成する。
FAIL_UNLESS_VALID_PAYMENT_METHODフィールドを指定しない場合も、この値を指定した場合も挙動は同じ。有効な支払い方法が無いと注文の作成に失敗する（＝従来通りの挙動）。
SKIP_PAYMENT_AND_CREATE_UNPAID_ORDERサブスク契約に有効な支払い方法が無くても、システムが未払い注文を作成する。決済処理をスキップして注文だけ先に立てるイメージ。
subscriptionBillingAttemptCreate 呼び出しは何もしなければ今まで通り動く（後方互換）。FAIL_UNLESS_VALID_PAYMENT_METHOD）では、支払い方法が無効なら注文は成功しない。未払い注文を作りたいときだけ SKIP_PAYMENT_AND_CREATE_UNPAID_ORDER を明示する。| 項目 | FAIL_UNLESS_VALID_PAYMENT_METHOD（既定・省略時） | SKIP_PAYMENT_AND_CREATE_UNPAID_ORDER |
|---|---|---|
| 有効な支払い方法が必要か | 必須 無いと注文作成に失敗 | 不要 無くても注文を作成 |
| 作られる注文 | 通常の注文（決済処理あり） | 未払い注文（決済をスキップ） |
| フィールド省略時の扱い | これと同じ | — |
| 後方互換 | 従来どおり | 明示指定が必要な新挙動 |
この機能は 2026-04 release candidate で利用可能になったもの。正式版での提供時期や仕様確定については記事に記載なし。
具体的な実装手順は「サブスク契約の構築（building a subscription contract）」のドキュメントを参照、と案内されている。API スキーマの細部やエラー挙動はそちらで確認する。
subscriptionBillingAttemptCreate ミューテーション。未払い注文の後続フロー（請求書発行・入金消込・督促など）の具体は記事に記載なし。subscriptionBillingAttemptCreate に paymentProcessingPolicy を渡すだけ。既存の課金試行フローに 1 フィールド足す差分で済む。
未指定時は FAIL_UNLESS_VALID_PAYMENT_METHOD と同じ。既存コードは触らなければ挙動が変わらない。
SKIP_PAYMENT_AND_CREATE_UNPAID_ORDER は決済処理を行わずに注文を作る。入金の回収は注文作成後の別フローで担保する設計が前提。
挙動は「契約に有効な支払い方法があるか」に依存。未払い注文化を狙うフローでは、契約側の支払い方法状態を意識した実装になる。
リリース候補版で利用可能になった機能。本番採用時は API バージョンを 2026-04 に固定し、未払い注文の生成・後続処理をサンドボックスで検証してから載せる。実装の詳細は「building a subscription contract」ドキュメントに従う。
SKIP_PAYMENT_AND_CREATE_UNPAID_ORDER を指定し、未払い注文として注文を作成。請求・入金は別途オフラインで処理。subscriptionBillingAttemptCreate 実行時にポリシーを切り替えるだけ。入金消込は注文作成後の自社/外部フローで担保する。SKIP_PAYMENT_AND_CREATE_UNPAID_ORDER を渡す分岐を実装する。paymentProcessingPolicy が追加。SKIP_PAYMENT_AND_CREATE_UNPAID_ORDER を指定すれば、有効な支払い方法が無くても『未払い注文』を作れる。