購入者ポータル
お客様が買ったものを開き直す画面。
購入者ポータルは、お客様が買ったものを開き直したり、ファイルを受け取ったりする Cozeni の画面です。自分のサイトからこの画面へ送るリンクを置けます。
お客様ができること
- 購入した商品の一覧を見る。
- 購入者限定ページを開き直す。
- ファイルをダウンロードする。
- ログアウトする。画面には「
{メールアドレス}でログイン中」と表示されます。ログアウトで消えるのは Cozeni 側の入場だけで、自分のサイトに保存された Cookie は残ります。
機能フラグの商品は一覧に表示されません。機能フラグは、お客様が見る画面を持たないためです。
ポータルの役割
- お客様は会員登録をせず、メールに届く確認コードで入場します。買った商品をあとから開き直すときに使う画面が、購入者ポータルです。
- ファイルは、お客様が購入者ポータルからダウンロードします。ダウンロードのページを自分で作る必要はありません。
- 購入完了メールに購入者ポータルへのボタンが付くので、自分のサイトにリンクを置かなくても、お客様はポータルを開けます。
お客様をポータルへ送る
お客様が購入者ポータルを開く方法は、ポータルの URL、自分のサイトからのリンク、Cozeni が送るメールの3つです。
ポータルの URL
購入者ポータルの URL は自分のクリエイターIDで決まります。
| 環境 | URL |
|---|---|
| 本番 | https://checkout.cozeni.net/portal/{クリエイターID} |
| サンドボックス | https://checkout-sandbox.cozeni.net/portal/{クリエイターID} |
購入者ポータルには確認コードで入場します。入場していない場合は、確認コードの送り先がこのブラウザに残っていれば(購入したのと同じブラウザなど)確認コードの入力画面が、残っていなければ(別の端末で開いたときなど)先にメールアドレスの入力画面が出ます。
クリエイターID(cre_ で始まる値)は CLI の whoami コマンドで確認できます。サンドボックスと本番では値が違います。
自分のサイトから送る
自分のサイトに「購入した商品」のようなボタンを置くと、お客様は確認コードなしでポータルを開けます。ボタンが押されたときに Cozeni がリンクを作り、SDK がお客様をそのリンクへ送ります。リンクにはポータル用の使い捨てのコードが付き、60秒で切れて1回しか使えません。
- ボタンのリンク先を自分のサイトのルート(例:
/portal)にします。 - そのルートで、SDK の
portalRedirect()を呼びます。 - 作られたリンクへ、お客様は 302 でリダイレクトされます。
import { portalRedirect } from "@nulogic/cozeni-sdk/next";
// 販売者のクリエイターID(cre_ で始まる。秘密ではない)
const CREATOR_ID = "cre_...";
export const dynamic = "force-dynamic";
// 押されたときに購入者ポータルへのリンクを作り、302 で送る
export function GET() {
return portalRedirect(CREATOR_ID);
}
ボタンは <a> で作ってください。Next.js の <Link> は表示時に先読みしてリンクを作るため、押される前にリンクが使い切られたり切れたりします。
<a href="/portal">購入した商品を開く</a>
クリエイターIDの確かめ方は上の「ポータルの URL」を参照してください。
失敗したとき
- 自分のサイトで購入者の入場を確かめられない場合、
portalRedirect()はリンクを作らず、コードの付かない購入者ポータルへ送ります。Cozeni 側にもセッションがなければ、お客様はメールアドレスと確認コードで入場します。 - リンクを作れない場合(一時的な障害など)は、503 を返します。障害のときに、お客様を入場の画面へ送ることはしません。
- 返ったリンクが指定したクリエイターや環境と合わない場合は、ログに確認を促す文を出します。
CREATOR_IDと接続先の環境が合っているかを確認してください。
Cozeni が送るメール
- 購入完了メールには、「購入した商品を開く」ボタンがあります。機能フラグの商品だけを購入した場合は、このボタンは出ません。
- ボタンを押すと、購入者ポータルが開きます。
- 入場していない場合は、確認コードの送り先がこのブラウザに残っていれば(購入したのと同じブラウザなど)確認コードの入力画面が、残っていなければ(別の端末で開いたときなど)先にメールアドレスの入力画面が出ます。
購入完了メールには、購入者限定ページの URL や確認コードは含まれません。商品名・販売者名と、購入者ポータルへのボタンが載ります。
次に読むページ
購入者の入場とアクセス判定
お客様が確認コードで入場するしくみと、自分のサイトでの権利の確かめ方です。
ポータルへのリンクを作成する API
購入者ポータルへのリンクを作る API の仕様です。
Next.js の SDK
portalRedirect() などの Next.js 向けのヘルパーです。
コマンド一覧
クリエイターIDを確かめる whoami など、CLI のコマンドです。
よくある質問
お客様はどうやって入場しますか
メールアドレスと確認コードで入場します。お客様は会員登録をしません。自分のサイトで入場しているお客様は、自分のサイトのボタンから確認コードなしでポータルを開けます。詳しくは 購入者の入場とアクセス判定 を参照してください。
ポータルへのリンクを自分で送る必要はありますか
ありません。購入完了メールに「購入した商品を開く」ボタンがあり、お客様はそこからポータルを開けます。ただし、機能フラグの商品だけを購入した場合は、このボタンは出ません。自分のサイトにボタンを置くこともできます。
機能フラグの商品が一覧に出ないのはなぜですか
機能フラグは、お客様が見る画面を持たないためです。
ポータルをオフにしたり、見た目を変えたりできますか
できません。管理画面には、購入者ポータルの設定はありません。