---
title: Next.js に組み込む
description: 購入リンクと購入者限定ページを、Next.js のサイトに手で組み込む。
---

Next.js（App Router）のサイトに、買い切りの商品の購入リンクと、購入者限定ページを組み込みます。手順は実装する順に並んでいます。構成は SDK の導入例（[`examples/nextjs`](https://github.com/nulogic-jp/cozeni-sdk/tree/main/examples/nextjs)）と同じです。完成したコードは導入例で確かめられます。

:::note
AI エージェントに組み込ませる場合は、[AI エージェントで組み込む](/integrate/ai-agents) を見てください。このページは手で組み込むときの手順です。
:::

## SDK を入れる

サイトのプロジェクトのフォルダ（`package.json` のある場所）で、次のコマンドを実行します。`cre_...` は本番の管理画面の導入プロンプトに書かれた、本番のクリエイターIDに置き換えます。CLI は最初にサンドボックスへ接続し、このIDを本番へ切り替えるときの照合に使います。

```sh
npx @nulogic/cozeni-sdk@0.8.0 init --creator cre_... --json
```

`init` は SDK を `package.json` の依存に追加し、AI エージェント向けの手順書を置きます。ログインは不要です。手で入れる場合は、`npm i @nulogic/cozeni-sdk@0.8.0` を実行します。

## 環境変数を設定する

プロジェクトの `.env.local` に、次の値を書きます。

```sh title=".env.local"
COZENI_SITE_ORIGIN=http://localhost:3000
COZENI_ENVIRONMENT=sandbox
```

- `COZENI_SITE_ORIGIN` はサイトのオリジンです。パスを含めず、`https://example.com` の形で書きます。開発中は開発サーバーの URL を書きます。
- `COZENI_ENVIRONMENT=sandbox` はサンドボックスで試すときだけ書きます。本番では書きません。

:::caution
`.env.local` は Git に含めないでください。機能フラグを使う場合は、別に `COZENI_API_KEY` を設定します。詳しくは [Next.js](/integrate/sdk/nextjs) を見てください。
:::

## proxy を置く

Cozeni から戻ってきたお客様のコードを、サイトのサーバーで交換します。Next.js 16 では `proxy.ts` に、Next.js 15 では `middleware.ts` に書きます。違うのは export する名前だけです。

```ts title="proxy.ts"
export { cozeniProxy as proxy } from "@nulogic/cozeni-sdk/next";

export const config = {
  matcher: ["/((?!_next/static|_next/image|favicon.ico).*)"],
};
```

Next.js 15 では `middleware.ts` に `export { cozeniProxy as middleware } from "@nulogic/cozeni-sdk/next";` と書きます。

既存の proxy や middleware がある場合は、置き換えないでください。`handleCozeniHandoff` と `clearCozeniHandoff` を、既存の処理に組み込みます。

## 購入リンクを置く

サンドボックスで商品を作成して、商品IDと購入リンクを控えます。CLI の接続先は `.env.local` の `COZENI_ENVIRONMENT` では切り替わりません。`init --creator` を実行した場合は、CLI の既定の接続先がサンドボックスになります。`npm i` で入れた場合や、本番にログインしたことがある端末では、既定が本番のことがあります。テストのあいだは CLI のコマンドに `--profile sandbox` を付けてください。本番に商品を作ってしまうことを防げます。

1. **サンドボックスにログインする**

    `npx cozeni login --profile sandbox --json` を実行し、表示された URL をブラウザで開いて承認します。

2. **ログインを終える**

    承認したら `npx cozeni login --profile sandbox --complete --json` を実行します。

3. **商品を作る**

    `npx cozeni products create --profile sandbox --name "<商品名>" --price <円> --access-url "<購入後に表示するページのURL>" --yes --json` を実行します。`--yes` は内容を確かめてから付けます。

ログインの詳細は [CLI のログイン](/integrate/cli/authentication) を見てください。

:::tip
商品は管理画面でも作れます。サンドボックスの管理画面（`https://sandbox.cozeni.net`）で商品を作り、商品詳細の「プロダクトID」タブで商品IDを、「リンク」タブで購入リンクを控えます。サンドボックスで作った商品は、本番では使えません。詳しくは [購入リンク](/features/checkout/links) を見てください。
:::

CLI で作った場合は、出力の `data.product.id` と `data.checkout_link.url` を、次のように書きます。どちらも秘密ではないので、コードに書いてかまいません。

```ts title="lib/cozeni.ts"
// `npx cozeni products create` が出力した商品IDと購入リンク
export const PRODUCT_ID = "prd_...";
export const CHECKOUT_URL = "https://checkout.cozeni.net/checkout/...";
```

購入リンクは `<a href={CHECKOUT_URL}>購入する</a>` の形で置きます。

## 限定ページを守る

購入者限定ページでは表示の前に権利を確かめます。お客様に権利が無ければ、Cozeni の入場画面へ送ります。

```tsx title="app/members/page.tsx"
import { AccessDenied, requireEntitlement } from "@nulogic/cozeni-sdk/next";
import { PRODUCT_ID } from "../../lib/cozeni";

// 認可の結果を、リクエストをまたいでキャッシュしない
export const dynamic = "force-dynamic";

export default async function Members() {
  try {
    // 権利が無ければ入場画面へ redirect する
    await requireEntitlement(PRODUCT_ID);
  } catch (error) {
    // redirect() の例外は握りつぶさず、投げ直す
    if (!(error instanceof AccessDenied)) throw error;
    return <p>この商品の購入が確認できませんでした。</p>;
  }
  return (
    <main>
      <h1>購入者限定ページ</h1>
      <p>限定の内容です。</p>
    </main>
  );
}
```

権利はレイアウトで確認せず、保護するページごとに確認してください。Route Handler では `entitlement` と `denialResponse`、Server Action では `entitlement` の結果を返す形を使います。詳しくは [Next.js](/integrate/sdk/nextjs) を見てください。

## 購入者ポータルへのボタンを置く

自分の商品のうち、お客様が買ったものの一覧を開けるようにします。ボタンの遷移先の Route Handler で、ポータルへのリンクを発行してお客様を送ります。

```ts title="app/portal/route.ts"
import { portalRedirect } from "@nulogic/cozeni-sdk/next";

export const dynamic = "force-dynamic";

// ボタンが押されたときに、購入者ポータルへのリンクを発行して 302 で送る
export function GET() {
  return portalRedirect("cre_...");
}
```

`cre_...` は `npx cozeni whoami --profile sandbox --json` の `data.creator_id` です。本番へ切り替えたあとは、本番のクリエイターIDに置き換えます。ボタンは `<a href="/portal">購入した商品</a>` の形で置きます。`<Link>` は使わないでください。`<Link>` は先読みで、お客様が押す前にリンクを発行してしまいます。リンクは60秒で失効します。

## サンドボックスで確かめる

開発サーバーを起動したままにして、テスト購入します。

```sh
npx cozeni test-purchase --profile sandbox --product prd_... --site-origin http://localhost:3000 --json
```

CLI はテストカードで決済を確定させ、限定ページに入れることと、未購入では入場画面へ送られることを確かめます。確かめたあとに、テスト購入を返金します。購入権の確定を待ちきれなかったときは、終了コード6で戻ります。同じコマンドを打ち直してください。

CLI を使わずに、開発サーバーの購入リンクから購入することもできます。テストカードは `4242 4242 4242 4242` です。購入画面で使えるメールアドレスは、管理画面のサインインに使うメールアドレスだけです。届いたコードを入力すると、限定ページに入れます。

## 本番へ切り替える

本番にログインして、本番で商品を作ります。

```sh
npx cozeni login --profile production --json
# ブラウザで承認したあと
npx cozeni login --complete --profile production --json
npx cozeni products create --profile production --name "<商品名>" --price <円> --access-url "<本番の公開URL>/members" --yes --json
```

1. このページの手順どおり `--profile` を付けずに `init --creator` で始めた場合（本番の管理画面の導入プロンプトと同じ流れ）は、`login --complete` が成功すると既定の接続先が本番に切り替わります。`init --profile sandbox` で始めた端末では、既定はサンドボックスのままです。どちらの場合も、本番のコマンドには `--profile production` を付けてください。
2. `products create` が返した商品IDと購入リンクで、`lib/cozeni.ts` を書き換えます。`app/portal/route.ts` の `cre_...` も `init --creator` に渡した本番のクリエイターIDに置き換えます（`npx cozeni whoami --profile production --json` の `data.creator_id` でも確かめられます）。
3. 本番の環境変数から `COZENI_ENVIRONMENT` を外します。機能フラグのために `COZENI_API_KEY` を置いている場合は、本番の管理画面で本番のキーを発行し、差し替えます。`COZENI_SITE_ORIGIN` には公開している URL を設定します。未設定だと、お客様は購入後に限定ページを開けません。
4. 本番では決済を試しません。購入していない状態で限定ページを開き、入場画面へ送られることを確かめます。

:::note
本番の管理画面の導入プロンプトから始めた導入で、本番にログイン済みで、期待するクリエイターと一致しているときは、承認は不要です。`login` の代わりに `npx cozeni switch --json` を実行します。本番の環境変数の設定とデプロイは自分で済ませます。
:::

## 次に読むページ

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

proxy、ページの認可、Route Handler の関数を説明します。

**[サンドボックス](/integrate/sandbox)**

テスト購入と、本番との違いを説明します。
