サンドボックス
実際の決済をせずに、組み込みを試す環境。
サンドボックスは本番とは別のアカウントとデータで、実際の請求なしに組み込みを試せる環境です。テストカードで購入から入場までを確かめられます。組み込みが終わったら、本番へ切り替えます。
はじめる
会員登録する
サンドボックスの管理画面で会員登録します。会員登録だけで使い始められます。会員登録とサインインは本番と同じ方法です。
売上の受け取り先をテスト用の値で登録する
管理画面の指示に従って、売上の受け取り先を登録します。銀行口座は「テストアカウントを使用する」を選びます。本人確認は「シミュレーション」を選び、「確認成功」と「結果を送信する」を押します。SMS の確認コードを求められたら、000-000 を入力します。そのほかの項目は管理画面の導入プロンプトに書かれた「売上の受け取り先のテスト登録」の値を入れます。
商品を作る
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 と Next.js のページを見てください。
テスト購入
テスト購入はサンドボックスの商品で、購入から入場までを確かめる方法です。
npx cozeni test-purchase --profile sandbox --product prd_... --site-origin http://localhost:3000 --json
CLI はテストカードで決済を確定させ、開発サーバーの限定ページに入れることを確かめます。未購入のときは、Cozeni の入場画面へ送られることも確かめます。限定ページの商品では確かめたあとにテスト購入を返金します。購入者のワンタイムコードと Cookie は、出力に含まれません。
機能フラグの商品では機能が付与されたことを確かめて止まり、返金しません(出力の refunded は false)。アプリで機能を確かめたあと、次のコマンドで返金します。
npx cozeni test-purchase --profile sandbox --product prd_... --refund --json
テストカードは次のとおりです。
| カード番号 | 結果 |
|---|---|
4242 4242 4242 4242 |
決済が成功します。有効期限は未来の日付、CVC は任意の3桁です。 |
4000 0000 0000 0002 |
決済が拒否されます。注文と購入権はできません。 |
テスト購入の API(POST /products/{id}/test-purchase と、返金の API)は、サンドボックスでだけ使えます。本番の接続先では 404 になります。API のリファレンスは テスト購入 を見てください。
本番へ切り替える
商品を本番で作り直す
サンドボックスの商品は本番にコピーされません。本番の管理画面か、本番の CLI で同じ内容の商品を作ります。
商品IDと購入リンクを差し替える
コードの中の商品IDと購入リンクを、本番で作った商品のものに書き換えます。
サンドボックスの設定を外す
サイトの環境変数から COZENI_ENVIRONMENT を外します。本番ではこの変数を設定しません。
機能フラグのために COZENI_API_KEY を置いている場合は、本番の管理画面の開発者設定で本番のキー(cozeni_sk_ で始まる)を発行し、差し替えます。サンドボックスのキーを本番へ送ると、API が認証エラー(HTTP 401)を返し、購入画面の作成と機能フラグの照会がすべて失敗します。
本番で確かめる
本番では決済を試しません。購入していない状態で限定ページを開き、Cozeni の入場画面へ送られることだけを確かめます。
本番との違い
- 本番とは別のアカウントとデータです。本番のアカウント、キー、商品は、サンドボックスでは使えません。逆も同じです。
- API キーの接頭辞が違います。サンドボックスのキーは
cozeni_sk_sandbox_で始まります。キーを本番の API に送ると、認証エラー(HTTP 401)になります。 - 決済は実際には行われません。テストカードでだけ、決済を確定させます。
- 購入画面で使えるメールアドレスは、管理画面のサインインに使うメールアドレスだけです。
- 限定ページの商品のテスト購入は、確かめたあとに返金されます。機能フラグの商品では
--refundを付けて返金します。 - データの保持は保証しません。運営がサンドボックスのデータをリセットすることがあります。リセットするときは、14日前に管理画面の帯とメールで知らせます。
- 実際の入金はありません。
- 販売者の情報の審査は承認済みとして扱われるため、審査の差し戻しは試せません。
- Stripe の領収書メールはお客様に届きません。Cozeni から届くメールは、件名の先頭に「[サンドボックス]」が付き、送信者名が「Cozeni サンドボックス」になります。
- API キーと CLI のキーの本数の上限、レート制限の値は本番と同じです。有効な API キーは20本まで、CLI のキーは5本までです。レート制限の値は レート制限 を見てください。