商品
販売するものと価格を登録する。
商品は販売するものと価格を登録する単位です。商品を作ると、購入リンクも同時に作られます。商品の種類で、お客様に配布するものを決めます。
商品を作る
管理画面で新しい商品を登録し、次の項目を入力します。購入者限定ページと機能フラグの商品は、CLI と外部 API からも作れます。ファイルの商品は管理画面からだけ作れます。
- 商品の種類を選ぶ:「購入者限定ページ」「ファイル」「機能フラグ」のどれか
- 商品名と価格:商品名は200字までです
- 種類ごとの中身:購入者限定ページのURL、ファイル、または機能フラグの設定値
- 必要に応じて、購入完了ページ・説明文・画像
各種類の詳細は 商品の種類の概要 を参照してください。
支払いのタイプ
今は買い切りの商品だけを作れます。お客様は一度支払えば、全額返金されるまで購入した商品を使い続けられます。
月額・年額で自動で更新するサブスクリプションは、公開に向けて準備中です。
価格
- 価格は日本円の整数で入力します。50円から9,999,999円までです。
- 金額は円のまま入れます。100倍にはしません。API では
price_jpyに整数で渡します(3,000円ならprice_jpy: 3000)。 - Cozeni は消費税を計算しません。入力した価格がそのままお客様への請求額になります。詳しくは 決済のしくみ を参照してください。
商品の種類
支払いが終わると、Cozeni が商品の種類に応じたものをお客様に自動で配布します。全額返金した注文では、配布を自動で取り消します。
- 購入者限定ページ:自分のサイトのページを、購入したお客様だけが開けるようにします。
- ファイル:お客様は購入者ポータルからダウンロードします。
- 機能フラグ:アプリの限定機能を、購入の有無と設定値で出し分けます。
種類ごとの違いと、お客様が購入した商品を使えるようになるとき・使えなくなるときは、商品の種類の概要 を参照してください。
購入画面での見せ方
説明文と画像で、購入画面での商品の見せ方を決めます。説明文と画像は、販売できる状態になるまで購入画面には表示されません。
説明文
- 説明文は Markdown で書きます。4,000字までです。
- 説明文では、見出し・太字・斜体・箇条書き・引用・区切り線・リンク(http・https)・改行が使えます。画像と生の HTML は表示されません。
画像
- 画像は1商品に1枚です。JPEG・PNG・WebP の形式で、5MB までです。16:9 の横長の画像がきれいに表示されます。
- 画像を差し替えると、画像の URL が変わります。古い URL は差し替えたあとも開けることがあります。公開したくない画像はアップロードしないでください。
- 画像の保存だけに失敗した場合も、商品のほかの内容は保存されています。商品詳細の案内に従い、編集から画像を登録し直してください。
購入完了ページ
購入完了ページ(success_url)を設定すると、お客様は決済が終わった後にそのページへ移動します。Cozeni の完了画面は表示されません。購入者限定ページの商品では、そのページに限定ページへのリンクを置いてください。
購入の上限
1つのメールアドレスで同じ商品を買えるのは1回までです。この上限は変えられません。
- 購入リンクの購入画面では、お客様がメールアドレスを入力した時点で Cozeni が確かめます。購入済みなら、支払いの欄の代わりに「すでに購入済みです」と表示され、支払いに進めません。
- 購入者限定ページとファイルの商品では、お客様は「メールアドレスを確認する」ボタンから購入した商品を開けます。
- 機能フラグの商品ではアプリにログインして使うよう案内が表示されます。
- 外部 API で購入画面を作るときは、購入済みのメールアドレスだと 409
already_purchasedが返り、購入画面は作られません。購入済みとして扱い、アプリの機能を使ってもらってください。詳しくは 購入画面の API を参照してください。 - 全額返金した注文は数えません。全額返金を受けたお客様はもう一度購入できます。部分返金では購入済みのままです。
商品を変更する
作成した商品は管理画面の商品の編集で次の項目を変えられます。
- 商品名と価格
- 種類ごとの中身:購入者限定ページのURL、ファイル、または機能フラグの設定値
- 購入完了ページ・説明文・画像
種類ごとの中身を変えると、既存のお客様にも反映されます。購入者限定ページのURLとファイルはすぐに、機能フラグの設定値は次の照会から反映されます。外したファイルは購入済みのお客様も見られなくなります。
価格を変えると、これから作られる購入に適用されます。作成済みの購入画面や、確定した注文の価格は変わりません。
商品の種類は作成後に変えられません。種類を変えたいときは、商品をアーカイブして作り直します。
商品一覧
管理画面の「商品」で、作った商品を一覧で確かめられます。
- 「商品名で検索」の欄で、商品名で検索できます。一部だけ入力しても見つかります。大文字と小文字は区別しません。
- 公開状態で絞り込めます。「公開中」「アーカイブ」から選びます。最初は「公開中」です。
- 並べ替えは「新しい順」「古い順」「価格が安い順」「価格が高い順」から選びます。最初は「新しい順」です。
- 各行の「チェックアウトURLをコピー」ボタンで、その商品の購入リンクの URL をコピーできます。
- 各行のメニューから、商品の「編集」と、「アーカイブ」または「販売を再開」を選べます。
まとめてアーカイブする・販売を再開する
複数の商品を選んで、まとめてアーカイブしたり、販売を再開したりできます。
- 一覧の各行のチェックボックスで商品を選びます。選ぶと「〇件を選択中」と表示されます。
- 「公開中」で絞り込んでいるときは「アーカイブ」を、「アーカイブ」で絞り込んでいるときは「販売を再開」を押します。
- 確認の画面で「アーカイブする」または「販売を再開する」を押します。
検索や絞り込みで見えなくなった商品は、選んでいても対象になりません。一部の商品だけ失敗したときは、何件が成功し、何件が失敗したかが表示されます。もう一度試してください。
アーカイブ
商品の状態は「公開中」か「アーカイブ」のどちらかです。
- アーカイブすると、その商品の購入リンクでの新規購入が止まります。既存のお客様は引き続き購入した商品を使えます。
- 管理画面の商品詳細にあるメニューから商品をアーカイブします。「販売を再開」で元に戻すこともできます。
- 商品をアーカイブしたり販売を再開したりできるのは、管理画面からだけです。外部 API からはできません。
削除
商品は削除できません。販売を止めるときは、商品をアーカイブします。
API で扱う
外部 API からは商品の一覧・取得・作成・更新と、画像の設定・削除ができます。
- 作成には
Idempotency-Keyヘッダーが必要です。同じキーで同じ内容を送り直すと、同じ結果が返ります。同じキーで違う内容を送ると 409 になります。 - 更新では
access_type(商品の種類)を変えられません。 - 購入完了ページ(
success_url)は外部 API と CLI では設定できません。管理画面で設定します。 - 作成した商品の購入リンクは、購入リンクの API で取得します。
- 画像の設定は
PUT /products/{product_id}/imageに、multipart/form-dataのfile欄で画像を1枚送ります。スコープはproducts:writeです。
API の詳細は次を参照してください。
CLI でも商品を作れます。コマンドは コマンド一覧 を参照してください。
よくある質問
月額・年額の商品は売れますか
今は売れません。作れるのは買い切りの商品だけです。月額・年額で自動で更新するサブスクリプションは、公開に向けて準備中です。
価格をあとから変えられますか
変えられます。新しい価格は、これから作られる購入に適用されます。作成済みの購入画面や、確定した注文の価格は変わりません。
商品の種類をあとから変えられますか
変えられません。種類を変えたいときは、商品をアーカイブして作り直します。
同じお客様が同じ商品を2回買えますか
買えません。1つのメールアドレスで同じ商品を買えるのは1回までです。ただし、全額返金を受けたお客様はもう一度購入できます。
無料の商品は作れますか
作れません。価格は50円からです。
複数の商品をまとめてアーカイブできますか
できます。管理画面の「商品」の一覧で商品を選び、「アーカイブ」を押します。アーカイブした商品は、同じ方法でまとめて販売を再開できます。