Next.js に組み込む
購入リンクと購入者限定ページを、Next.js のサイトに手で組み込む。
Next.js(App Router)のサイトに、買い切りの商品の購入リンクと、購入者限定ページを組み込みます。手順は実装する順に並んでいます。構成は SDK の導入例(examples/nextjs)と同じです。完成したコードは導入例で確かめられます。
SDK を入れる
サイトのプロジェクトのフォルダ(package.json のある場所)で、次のコマンドを実行します。cre_... は本番の管理画面の導入プロンプトに書かれた、本番のクリエイターIDに置き換えます。CLI は最初にサンドボックスへ接続し、このIDを本番へ切り替えるときの照合に使います。
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 に、次の値を書きます。
COZENI_SITE_ORIGIN=http://localhost:3000
COZENI_ENVIRONMENT=sandbox
COZENI_SITE_ORIGINはサイトのオリジンです。パスを含めず、https://example.comの形で書きます。開発中は開発サーバーの URL を書きます。COZENI_ENVIRONMENT=sandboxはサンドボックスで試すときだけ書きます。本番では書きません。
proxy を置く
Cozeni から戻ってきたお客様のコードを、サイトのサーバーで交換します。Next.js 16 では proxy.ts に、Next.js 15 では middleware.ts に書きます。違うのは export する名前だけです。
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 を付けてください。本番に商品を作ってしまうことを防げます。
サンドボックスにログインする
npx cozeni login --profile sandbox --json を実行し、表示された URL をブラウザで開いて承認します。
ログインを終える
承認したら npx cozeni login --profile sandbox --complete --json を実行します。
商品を作る
npx cozeni products create --profile sandbox --name "<商品名>" --price <円> --access-url "<購入後に表示するページのURL>" --yes --json を実行します。--yes は内容を確かめてから付けます。
ログインの詳細は CLI のログイン を見てください。
CLI で作った場合は、出力の data.product.id と data.checkout_link.url を、次のように書きます。どちらも秘密ではないので、コードに書いてかまいません。
// `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 の入場画面へ送ります。
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 を見てください。
購入者ポータルへのボタンを置く
自分の商品のうち、お客様が買ったものの一覧を開けるようにします。ボタンの遷移先の Route Handler で、ポータルへのリンクを発行してお客様を送ります。
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秒で失効します。
サンドボックスで確かめる
開発サーバーを起動したままにして、テスト購入します。
npx cozeni test-purchase --profile sandbox --product prd_... --site-origin http://localhost:3000 --json
CLI はテストカードで決済を確定させ、限定ページに入れることと、未購入では入場画面へ送られることを確かめます。確かめたあとに、テスト購入を返金します。購入権の確定を待ちきれなかったときは、終了コード6で戻ります。同じコマンドを打ち直してください。
CLI を使わずに、開発サーバーの購入リンクから購入することもできます。テストカードは 4242 4242 4242 4242 です。購入画面で使えるメールアドレスは、管理画面のサインインに使うメールアドレスだけです。届いたコードを入力すると、限定ページに入れます。
本番へ切り替える
本番にログインして、本番で商品を作ります。
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
- このページの手順どおり
--profileを付けずにinit --creatorで始めた場合(本番の管理画面の導入プロンプトと同じ流れ)は、login --completeが成功すると既定の接続先が本番に切り替わります。init --profile sandboxで始めた端末では、既定はサンドボックスのままです。どちらの場合も、本番のコマンドには--profile productionを付けてください。 products createが返した商品IDと購入リンクで、lib/cozeni.tsを書き換えます。app/portal/route.tsのcre_...もinit --creatorに渡した本番のクリエイターIDに置き換えます(npx cozeni whoami --profile production --jsonのdata.creator_idでも確かめられます)。- 本番の環境変数から
COZENI_ENVIRONMENTを外します。機能フラグのためにCOZENI_API_KEYを置いている場合は、本番の管理画面で本番のキーを発行し、差し替えます。COZENI_SITE_ORIGINには公開している URL を設定します。未設定だと、お客様は購入後に限定ページを開けません。 - 本番では決済を試しません。購入していない状態で限定ページを開き、入場画面へ送られることを確かめます。