---
title: 購入者限定ページ
description: 自分のサイトに限定ページを作る。
---

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

## 使いどころ

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

## 管理画面で設定する

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

:::note
商品の種類は作成後に変えられません。購入者限定ページのURLを変えると、既存のお客様にもすぐ反映されます。
:::

## お客様から見た流れ

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

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

:::tip
商品に購入完了ページ（`success_url`）を設定すると、お客様は決済後にそのページへ移動します。Cozeni の完了画面は表示されません。その場合は、購入完了ページに限定ページへのリンクを置いてください。
:::

### 購入完了メール

決済が成立すると、Cozeni はお客様に購入完了メールを1通送ります。メールには商品名・販売者名と、「購入した商品を開く」ボタンが載ります。ボタンを押すと購入者ポータルが開きます。入場していないときは、確認コードの送り先がこのブラウザに残っていれば（購入したのと同じブラウザなど）、確認コードの入力画面が出ます。残っていなければ（別の端末で開いたときなど）、先にメールアドレスの入力画面が出ます。

購入完了メールには、購入者限定ページの URL や確認コードは含まれません。

### 2回目以降に開く

お客様は2回目以降、購入者ポータルから限定ページを開けます。購入完了メールのボタンからもポータルを開けます。購入者ポータルの入り方は [購入者ポータル](/features/customer-portal) を参照してください。

## サイトに組み込む（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 として読み込まれず、ハンドオフが動きません。

```ts proxy.ts
// 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()` はページの入口だけで使います。権利がなければ、購入者の入口へリダイレクトします。

```tsx app/members/page.tsx
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()` は使いません。

```ts app/api/members/route.ts
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` などの理由でもリダイレクトせず、拒否表示になります。交換に失敗したときに、入口との間でリダイレクトが繰り返されるのを防ぐためです。

判定の詳細は [購入者の入場とアクセス判定](/features/customer-access) を、API の仕様は [権利の確認](/api-reference/customer/external-check-entitlements) を参照してください。

## よくある質問

**購入者限定ページのURLを変えると、購入済みのお客様はどうなりますか**

すぐに反映されます。購入済みのお客様も、変えたあとの URL を開きます。

**購入完了メールに限定ページの URL は載りますか**

載りません。購入完了メールには商品名・販売者名と、購入者ポータルを開く「購入した商品を開く」ボタンが載ります。確認コードも含まれません。

**お客様は2回目以降、どこから限定ページを開きますか**

購入者ポータルから開きます。購入完了メールのボタンからもポータルを開けます。自分のサイトにポータルへのリンクを置くこともできます。

**購入していない人が限定ページを開くとどうなりますか**

購入者の入口へ送られます。権利を判定できないとき（`unavailable`）は、リダイレクトせず拒否の表示になります。また、入場のコードを交換した直後（`cozeni_handoff` の Cookie が残っているとき）は、理由にかかわらずリダイレクトせず拒否の表示になります。交換に失敗したときに、入口との間でリダイレクトが繰り返されるのを防ぐためです。

## 次に読むページ

**[購入者の入場とアクセス判定](/features/customer-access)**

お客様が確認コードで入場するしくみと、自分のサイトでの権利の確かめ方です。

**[購入者ポータル](/features/customer-portal)**

お客様が買ったものを開き直したり、ファイルを受け取ったりする画面です。

**[Next.js の SDK](/integrate/sdk/nextjs)**

`requireEntitlement()` などの Next.js 向けのヘルパーです。

**[権利の確認（API）](/api-reference/customer/external-check-entitlements)**

権利を確認する API の仕様です。
