---
search:
  tags:
    - 購入画面
    - POST
seo:
  description: >-
    必要なスコープ: checkouts:write。販売者のサーバーが、ログイン中のユーザーのメールア… Reference for the POST
    /checkout/sessions endpoint in the Cozeni 外部 API.
sidebar:
  label: メールアドレスを固定した購入画面を作る
  badge: POST
title: メールアドレスを固定した購入画面を作る
type: openapi-operation
---
必要なスコープ: checkouts:write。販売者のサーバーが、ログイン中のユーザーのメールアドレスで購入試行を作り、購入画面の URL を返す。購入画面ではメールアドレスを変更できず、照会 API（POST /customers/state）で引くメールアドレスとの食い違いを防ぐ。商品の種類（機能フラグ・購入者限定ページ）は問わない。そのメールアドレスがすでに購入済みで、購入制限に達しているときは 409 already_purchased（作らない）。有効期限は30分。URL には購入者のメールアドレスが紐づくので、ログイン中の本人にだけ渡す。

`POST /checkout/sessions`

**Request body** (`application/json`, required)

- `product_id` (string, required) — 販売する商品の ID。自分の商品で、標準の購入リンクがあるもの。
- `email` (string<email>, required) — 購入者のメールアドレス（販売者のアプリでログイン中のユーザーのもの）。前後の空白を除き、小文字にそろえて保存する。購入画面では変更できない。URL には載せない（POST）。

Request body example:

```json
{
  "product_id": "prd_0123456789abcdef0123456789abcdef",
  "email": "hanako@example.com"
}
```

**Responses**

- `201` — 購入試行の ID・購入画面の URL・有効期限。
- `400` — invalid\_input。メール形式の誤り・product\_id なし・未知フィールド・JSON でない本文。
- `401` — unauthorized。失効、期限切れ、環境違いを含む。
- `403` — insufficient\_scope。checkouts:write が必要。
- `404` — product\_not\_found。他の販売者の商品・存在しない商品・標準リンクが無い商品。
- `409` — creator\_not\_ready（審査未承認・Stripe 未接続）または already\_purchased（購入済みで購入制限に達している）。
- `410` — product\_archived（アーカイブ済み・未公開）または checkout\_link\_disabled（標準リンクが無効）。既存の購入画面と同じ。
- `422` — sandbox\_recipient\_not\_allowed。サンドボックスで、販売者本人のサインイン用メールアドレス以外を指定した。
- `429` — rate\_limited。管理 API と同じ枠（キー・販売者・IP）。
- `500` — internal。DB の障害を含む。

Response example, 201:

```json
{
  "checkout_id": "string",
  "url": "http://example.com",
  "expires_at": "2019-08-24T14:15:22Z"
}
```
