購入者限定ページ
自分のサイトに限定ページを作る。
購入者限定ページは自分のサイトに限定ページを作るための商品の種類です。お客様は確認コードで入場し、ページを開きます。購入していない人は購入者の入口へ送られます。
使いどころ
自分のサイトにあるページを、購入したお客様だけが開けるようにしたいときに使います。たとえば、記事の続きを有料で公開するときです。ページそのものは自分のサイトに置いたままで、Cozeni は購入の確認と、お客様の入場を受け持ちます。
管理画面で設定する
- 商品を登録するときに、商品の種類で「購入者限定ページ」を選びます。
- 「購入者限定ページのURL」に、自分のサイトの限定ページの URL を入れます。
お客様から見た流れ
- お客様は購入画面で、メールアドレスを入力してカードで支払います。
- 決済完了画面の「メールアドレスを確認する」を押します。
- 届いた6桁の確認コードを入力します。
- 限定ページが開きます。
購入直後は購入者のセッションがないため、確認コードの入力が必要です。
購入完了メール
決済が成立すると、Cozeni はお客様に購入完了メールを1通送ります。メールには商品名・販売者名と、「購入した商品を開く」ボタンが載ります。ボタンを押すと購入者ポータルが開きます。入場していないときは、確認コードの送り先がこのブラウザに残っていれば(購入したのと同じブラウザなど)、確認コードの入力画面が出ます。残っていなければ(別の端末で開いたときなど)、先にメールアドレスの入力画面が出ます。
購入完了メールには、購入者限定ページの URL や確認コードは含まれません。
2回目以降に開く
お客様は2回目以降、購入者ポータルから限定ページを開けます。購入完了メールのボタンからもポータルを開けます。購入者ポータルの入り方は 購入者ポータル を参照してください。
サイトに組み込む(SDK・API)
SDK の @nulogic/cozeni-sdk/next を使います。限定ページの入口ごとに権利を確かめます。
1. 環境変数を設定する
COZENI_SITE_ORIGIN:自分のサイトのオリジン(必須)。ハンドオフ後の戻り先に使います。COZENI_ENVIRONMENT:開発中にサンドボックスへつなぐときだけsandboxを設定します。本番では設定しません。
2. proxy.ts でハンドオフを処理する
Next.js 16 では proxy.ts に次のように書きます。Next.js 15 では middleware.ts に書き、export 名も middleware にします(export { cozeniProxy as middleware } from "@nulogic/cozeni-sdk/next";)。名前が proxy のままだと middleware として読み込まれず、ハンドオフが動きません。
// Cozeni から戻ったときの cozeni_code の交換と、無限リダイレクトを止める印の管理を SDK に任せる
export { cozeniProxy as proxy } from "@nulogic/cozeni-sdk/next";
export const config = {
// 静的ファイルでは動かさない。限定ページは必ず対象に含める
matcher: ["/((?!_next/static|_next/image|favicon.ico).*)"],
};
既存の middleware がある場合は、cozeniProxy に置き換えないでください。handleCozeniHandoff() と clearCozeniHandoff() を既存の処理に組み込みます。
3. 限定ページの入口で権利を確かめる
requireEntitlement() はページの入口だけで使います。権利がなければ、購入者の入口へリダイレクトします。
import { AccessDenied, requireEntitlement } from "@nulogic/cozeni-sdk/next";
// 商品ID(秘密ではない)
const PRODUCT_ID = "prd_...";
export default async function MembersPage() {
try {
// 権利が無ければ入口へリダイレクトする
await requireEntitlement(PRODUCT_ID);
} catch (error) {
// redirect() の例外は握りつぶさず投げ直す。AccessDenied だけを拒否表示にする
if (!(error instanceof AccessDenied)) throw error;
return <p>この商品の購入を確認できませんでした。</p>;
}
return <main>限定の内容</main>;
}
4. データ取得・Route Handler・Server Action でも確かめる
レイアウトで子要素を隠すだけでは不十分です。保護する内容を返すすべての入口で、権利を確かめてください。
- Route Handler:
entitlement()で判定し、拒否ならdenialResponse()で 401・403・503 の JSON を返します。 - Server Action:
entitlement()の結果を、通常の戻り値として返します。redirect()やdenialResponse()は使いません。
import { denialResponse, entitlement } from "@nulogic/cozeni-sdk/next";
const PRODUCT_ID = "prd_...";
export async function GET() {
const result = await entitlement(PRODUCT_ID);
if (!result.entitled) return denialResponse(result, PRODUCT_ID);
return Response.json(
{ content: "限定の内容" },
{ headers: { "Cache-Control": "private, no-store" } },
);
}
拒否の理由
| 理由 | 意味 | requireEntitlement() の動き |
|---|---|---|
no_grant |
購入していない、または商品が分からない | 入口へリダイレクト |
revoked |
権利が外れている(全額返金など) | 入口へリダイレクト |
no_session |
入場がない、または期限切れ | 入口へリダイレクト |
unavailable |
権利を判定できない | リダイレクトせず拒否表示 |
入場のコードを交換した直後(cozeni_handoff の Cookie が残っているとき)は、no_session などの理由でもリダイレクトせず、拒否表示になります。交換に失敗したときに、入口との間でリダイレクトが繰り返されるのを防ぐためです。
判定の詳細は 購入者の入場とアクセス判定 を、API の仕様は 権利の確認 を参照してください。
よくある質問
購入者限定ページのURLを変えると、購入済みのお客様はどうなりますか
すぐに反映されます。購入済みのお客様も、変えたあとの URL を開きます。
購入完了メールに限定ページの URL は載りますか
載りません。購入完了メールには商品名・販売者名と、購入者ポータルを開く「購入した商品を開く」ボタンが載ります。確認コードも含まれません。
お客様は2回目以降、どこから限定ページを開きますか
購入者ポータルから開きます。購入完了メールのボタンからもポータルを開けます。自分のサイトにポータルへのリンクを置くこともできます。
購入していない人が限定ページを開くとどうなりますか
購入者の入口へ送られます。権利を判定できないとき(unavailable)は、リダイレクトせず拒否の表示になります。また、入場のコードを交換した直後(cozeni_handoff の Cookie が残っているとき)は、理由にかかわらずリダイレクトせず拒否の表示になります。交換に失敗したときに、入口との間でリダイレクトが繰り返されるのを防ぐためです。