---
title: サンドボックス
description: 実際の決済をせずに、組み込みを試す環境。
---

サンドボックスは本番とは別のアカウントとデータで、実際の請求なしに組み込みを試せる環境です。テストカードで購入から入場までを確かめられます。組み込みが終わったら、本番へ切り替えます。

:::note
サンドボックスは本番の中のテストモードではなく別の環境です。本番と同じ仕組みを、データベースから分けて別に動かしています。テストの購入で本番の購入権が付いたり、本番の注文や決済の記録にテストのデータが混ざったりしないようにするためです。そのため、アカウント、API キー、商品も本番とは別になります。
:::

## はじめる

1. **会員登録する**

    サンドボックスの管理画面で会員登録します。会員登録だけで使い始められます。会員登録とサインインは本番と同じ方法です。

2. **売上の受け取り先をテスト用の値で登録する**

    管理画面の指示に従って、売上の受け取り先を登録します。銀行口座は「テストアカウントを使用する」を選びます。本人確認は「シミュレーション」を選び、「確認成功」と「結果を送信する」を押します。SMS の確認コードを求められたら、`000-000` を入力します。そのほかの項目は管理画面の導入プロンプトに書かれた「売上の受け取り先のテスト登録」の値を入れます。

3. **商品を作る**

    CLI の `products create` か、管理画面で商品を作ります。サンドボックスで作った商品は、本番では使えません。

サンドボックスでは、販売者の情報の申請と審査は不要です。

## 接続先

| 項目 | 本番（既定） | サンドボックス |
| --- | --- | --- |
| 管理画面 | `https://cozeni.net` | `https://sandbox.cozeni.net` |
| API | `https://api.cozeni.net` | `https://api-sandbox.cozeni.net` |
| 購入画面 | `https://checkout.cozeni.net` | `https://checkout-sandbox.cozeni.net` |
| API キーの接頭辞 | `cozeni_sk_` | `cozeni_sk_sandbox_` |
| CLI | `--profile production` | `--profile sandbox` |
| JavaScript / TypeScript SDK | `environment` を指定しない（既定） | `environment: "sandbox"` |
| Next.js のヘルパー | 環境変数 `COZENI_ENVIRONMENT` を設定しない | 環境変数 `COZENI_ENVIRONMENT=sandbox` |

SDK で接続先を指定するには、[JavaScript / TypeScript](/integrate/sdk/javascript) と [Next.js](/integrate/sdk/nextjs) のページを見てください。

## テスト購入

テスト購入はサンドボックスの商品で、購入から入場までを確かめる方法です。

```sh
npx cozeni test-purchase --profile sandbox --product prd_... --site-origin http://localhost:3000 --json
```

CLI はテストカードで決済を確定させ、開発サーバーの限定ページに入れることを確かめます。未購入のときは、Cozeni の入場画面へ送られることも確かめます。限定ページの商品では確かめたあとにテスト購入を返金します。購入者のワンタイムコードと Cookie は、出力に含まれません。

機能フラグの商品では機能が付与されたことを確かめて止まり、返金しません（出力の `refunded` は `false`）。アプリで機能を確かめたあと、次のコマンドで返金します。

```sh
npx cozeni test-purchase --profile sandbox --product prd_... --refund --json
```

テストカードは次のとおりです。

| カード番号 | 結果 |
| --- | --- |
| `4242 4242 4242 4242` | 決済が成功します。有効期限は未来の日付、CVC は任意の3桁です。 |
| `4000 0000 0000 0002` | 決済が拒否されます。注文と購入権はできません。 |

:::note
購入画面で使えるメールアドレスは、管理画面のサインインに使うメールアドレスだけです。ほかのメールアドレスでは購入画面を作れません（`sandbox_recipient_not_allowed`、HTTP 422）。
:::

テスト購入の API（`POST /products/{id}/test-purchase` と、返金の API）は、サンドボックスでだけ使えます。本番の接続先では `404` になります。API のリファレンスは [テスト購入](/api-reference/test-purchases/external-start-test-purchase) を見てください。

## 本番へ切り替える

1. **商品を本番で作り直す**

    サンドボックスの商品は本番にコピーされません。本番の管理画面か、本番の CLI で同じ内容の商品を作ります。

2. **商品IDと購入リンクを差し替える**

    コードの中の商品IDと購入リンクを、本番で作った商品のものに書き換えます。

3. **サンドボックスの設定を外す**

    サイトの環境変数から `COZENI_ENVIRONMENT` を外します。本番ではこの変数を設定しません。

    機能フラグのために `COZENI_API_KEY` を置いている場合は、本番の管理画面の開発者設定で本番のキー（`cozeni_sk_` で始まる）を発行し、差し替えます。サンドボックスのキーを本番へ送ると、API が認証エラー（HTTP 401）を返し、購入画面の作成と機能フラグの照会がすべて失敗します。

4. **本番で確かめる**

    本番では決済を試しません。購入していない状態で限定ページを開き、Cozeni の入場画面へ送られることだけを確かめます。

:::note
サンドボックスの商品IDが本番のコードに残っていても、エラーにはなりません。本番ではその商品の購入権がないため、入場画面へ送られるだけです。`npx cozeni products get <商品ID>` で、商品IDが本番のものかを確かめてください。
:::

## 本番との違い

- 本番とは別のアカウントとデータです。本番のアカウント、キー、商品は、サンドボックスでは使えません。逆も同じです。
- API キーの接頭辞が違います。サンドボックスのキーは `cozeni_sk_sandbox_` で始まります。キーを本番の API に送ると、認証エラー（HTTP 401）になります。
- 決済は実際には行われません。テストカードでだけ、決済を確定させます。
- 購入画面で使えるメールアドレスは、管理画面のサインインに使うメールアドレスだけです。
- 限定ページの商品のテスト購入は、確かめたあとに返金されます。機能フラグの商品では `--refund` を付けて返金します。
- データの保持は保証しません。運営がサンドボックスのデータをリセットすることがあります。リセットするときは、14日前に管理画面の帯とメールで知らせます。
- 実際の入金はありません。
- 販売者の情報の審査は承認済みとして扱われるため、審査の差し戻しは試せません。
- Stripe の領収書メールはお客様に届きません。Cozeni から届くメールは、件名の先頭に「[サンドボックス]」が付き、送信者名が「Cozeni サンドボックス」になります。
- API キーと CLI のキーの本数の上限、レート制限の値は本番と同じです。有効な API キーは20本まで、CLI のキーは5本までです。レート制限の値は [レート制限](/api-reference/rate-limits) を見てください。

## 次に読むページ

**[JavaScript / TypeScript](/integrate/sdk/javascript)**

SDK で接続先をサンドボックスに切り替える。

**[CLI](/integrate/cli)**

プロファイルの切り替えとテスト購入のコマンド。

**[販売者の審査](/pricing/account-review)**

本番で販売を始めるための接続と審査。

**[返金](/features/refunds)**

返金の操作と、閲覧権への影響。
