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

購入者ポータル

お客様が買ったものを開き直す画面。

購入者ポータルは、お客様が買ったものを開き直したり、ファイルを受け取ったりする 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回しか使えません。

  1. ボタンのリンク先を自分のサイトのルート(例:/portal)にします。
  2. そのルートで、SDK の portalRedirect() を呼びます。
  3. 作られたリンクへ、お客様は 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 や確認コードは含まれません。商品名・販売者名と、購入者ポータルへのボタンが載ります。

次に読むページ

よくある質問

お客様はどうやって入場しますか

メールアドレスと確認コードで入場します。お客様は会員登録をしません。自分のサイトで入場しているお客様は、自分のサイトのボタンから確認コードなしでポータルを開けます。詳しくは 購入者の入場とアクセス判定 を参照してください。

ポータルへのリンクを自分で送る必要はありますか

ありません。購入完了メールに「購入した商品を開く」ボタンがあり、お客様はそこからポータルを開けます。ただし、機能フラグの商品だけを購入した場合は、このボタンは出ません。自分のサイトにボタンを置くこともできます。

機能フラグの商品が一覧に出ないのはなぜですか

機能フラグは、お客様が見る画面を持たないためです。

ポータルをオフにしたり、見た目を変えたりできますか

できません。管理画面には、購入者ポータルの設定はありません。

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