コンテンツにスキップ
Docs
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

サンドボックス

実際の決済をせずに、組み込みを試す環境。

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

はじめる

会員登録する

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

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

管理画面の指示に従って、売上の受け取り先を登録します。銀行口座は「テストアカウントを使用する」を選びます。本人確認は「シミュレーション」を選び、「確認成功」と「結果を送信する」を押します。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本までです。レート制限の値は レート制限 を見てください。

次に読むページ

このページは役に立ちましたか?