---
search:
  tags:
    - テスト購入
    - POST
seo:
  description: >-
    サンドボックス専用（それ以外は404）。必要なスコープ:… Reference for the POST
    /products/{product_id}/test-purchase endpoint in the Cozeni 外部 API.
sidebar:
  label: テスト購入を行う（サンドボックスのみ）
  badge: POST
title: テスト購入を行う（サンドボックスのみ）
type: openapi-operation
---
サンドボックス専用（それ以外は404）。必要なスコープ: products:write。本文なし。購入者はキーの所有者本人（サインイン用メールアドレス）で、リクエストでは指定できない。購入権が無ければテストカードで決済を確定して202（pending）。注文・購入権は本番と同じWebhookでできるため、購入権ができるまで同じ要求を打ち直す。処理中の決済があれば新たに決済しない。購入権が既にあれば決済せず200（completed）と、OTPなしで発行するワンタイムコード（handoff_code。有効60秒・1回きり）を返す。コードはログ・出力に出さない。

`POST /products/{product_id}/test-purchase`

**Responses**

- `200` — 購入権がある。入場の確認用のワンタイムコード（限定ページの商品のみ）と、商品の種類（access\_type）・付与された設定値（metadata）を含む。
- `202` — 決済は済んだ（または処理中）。Webhook による購入権の付与を待つ。
- `400` — invalid\_input。未知フィールド、無効なcursor・入力を含む。
- `401` — unauthorized。失効、期限切れ、環境違いを含む。
- `403` — insufficient\_scope。
- `404` — not\_found（サンドボックス以外）/ product\_not\_found（他人の商品・存在しない商品）。
- `409` — creator\_not\_ready（売上の受け取り先が未登録・販売者の情報が未承認など。blockers は GET /account の sales.blockers と同じ）/ product\_archived / checkout\_link\_disabled / subscription\_not\_supported（サブスクの商品はテスト購入できない）。
- `429` — rate\_limited。
- `500` — internal。
- `502` — stripe\_error。Stripe の処理に失敗した。打ち直せる。
- `503` — unavailable。

Response example, 200:

```json
{
  "status": "completed",
  "handoff_code": "string",
  "expires_in": 0,
  "access_type": "page",
  "metadata": {
    "daily_messages": 100,
    "plan": "pro",
    "beta": true
  }
}
```
