メールアドレスを固定した購入画面を作る
必要なスコープ: checkouts:write。販売者のサーバーが、ログイン中のユーザーのメールアドレスで購入試行を作り、購入画面の URL を返す。購入画面ではメールアドレスを変更できず、照会 API(POST /customers/state)で引くメールアドレスとの食い違いを防ぐ。商品の種類(機能フラグ・購入者限定ページ)は問わない。そのメールアドレスがすでに購入済みで、購入制限に達しているときは 409 already_purchased(作らない)。有効期限は30分。URL には購入者のメールアドレスが紐づくので、ログイン中の本人にだけ渡す。
/checkout/sessionsAuthorizationBearer トークン · header必須管理画面または CLI の cozeni login で発行したクリエイターAPIキー。購入者認証には使わない。
application/jsonproduct_idstring必須販売する商品の ID。自分の商品で、標準の購入リンクがあるもの。
emailstring<email>必須購入者のメールアドレス(販売者のアプリでログイン中のユーザーのもの)。前後の空白を除き、小文字にそろえて保存する。購入画面では変更できない。URL には載せない(POST)。
購入試行の ID・購入画面の URL・有効期限。
checkout_idstring必須購入試行の ID。
urlstring<uri>必須購入画面の URL(?checkout=<checkout_id> 付き)。購入者をこの URL へ進める。メールアドレスは含まない。
expires_atstring<date-time>必須購入画面の有効期限(作成から30分)。過ぎたら作り直す。
invalid_input。メール形式の誤り・product_id なし・未知フィールド・JSON でない本文。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須unauthorized。失効、期限切れ、環境違いを含む。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須insufficient_scope。checkouts:write が必要。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須product_not_found。他の販売者の商品・存在しない商品・標準リンクが無い商品。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須creator_not_ready(審査未承認・Stripe 未接続)または already_purchased(購入済みで購入制限に達している)。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須product_archived(アーカイブ済み・未公開)または checkout_link_disabled(標準リンクが無効)。既存の購入画面と同じ。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須sandbox_recipient_not_allowed。サンドボックスで、販売者本人のサインイン用メールアドレス以外を指定した。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須rate_limited。管理 API と同じ枠(キー・販売者・IP)。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須internal。DB の障害を含む。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須