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

購入者限定ページ

自分のサイトに限定ページを作る。

購入者限定ページは自分のサイトに限定ページを作るための商品の種類です。お客様は確認コードで入場し、ページを開きます。購入していない人は購入者の入口へ送られます。

使いどころ

自分のサイトにあるページを、購入したお客様だけが開けるようにしたいときに使います。たとえば、記事の続きを有料で公開するときです。ページそのものは自分のサイトに置いたままで、Cozeni は購入の確認と、お客様の入場を受け持ちます。

管理画面で設定する

  1. 商品を登録するときに、商品の種類で「購入者限定ページ」を選びます。
  2. 「購入者限定ページのURL」に、自分のサイトの限定ページの URL を入れます。

お客様から見た流れ

  1. お客様は購入画面で、メールアドレスを入力してカードで支払います。
  2. 決済完了画面の「メールアドレスを確認する」を押します。
  3. 届いた6桁の確認コードを入力します。
  4. 限定ページが開きます。

購入直後は購入者のセッションがないため、確認コードの入力が必要です。

購入完了メール

決済が成立すると、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 が残っているとき)は、理由にかかわらずリダイレクトせず拒否の表示になります。交換に失敗したときに、入口との間でリダイレクトが繰り返されるのを防ぐためです。

次に読むページ

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