---
title: 購入者ポータル
description: お客様が買ったものを開き直す画面。
---

購入者ポータルは、お客様が買ったものを開き直したり、ファイルを受け取ったりする Cozeni の画面です。自分のサイトからこの画面へ送るリンクを置けます。

## お客様ができること

- 購入した商品の一覧を見る。
- 購入者限定ページを開き直す。
- ファイルをダウンロードする。
- ログアウトする。画面には「`{メールアドレス}` でログイン中」と表示されます。ログアウトで消えるのは Cozeni 側の入場だけで、自分のサイトに保存された Cookie は残ります。

機能フラグの商品は一覧に表示されません。機能フラグは、お客様が見る画面を持たないためです。

## ポータルの役割

- お客様は会員登録をせず、メールに届く確認コードで入場します。買った商品をあとから開き直すときに使う画面が、購入者ポータルです。
- ファイルは、お客様が購入者ポータルからダウンロードします。ダウンロードのページを自分で作る必要はありません。
- 購入完了メールに購入者ポータルへのボタンが付くので、自分のサイトにリンクを置かなくても、お客様はポータルを開けます。

## お客様をポータルへ送る

お客様が購入者ポータルを開く方法は、ポータルの URL、自分のサイトからのリンク、Cozeni が送るメールの3つです。

### ポータルの URL

購入者ポータルの URL は自分のクリエイターIDで決まります。

| 環境 | URL |
| --- | --- |
| 本番 | `https://checkout.cozeni.net/portal/{クリエイターID}` |
| サンドボックス | `https://checkout-sandbox.cozeni.net/portal/{クリエイターID}` |

購入者ポータルには確認コードで入場します。入場していない場合は、確認コードの送り先がこのブラウザに残っていれば（購入したのと同じブラウザなど）確認コードの入力画面が、残っていなければ（別の端末で開いたときなど）先にメールアドレスの入力画面が出ます。

クリエイターID（`cre_` で始まる値）は CLI の `whoami` コマンドで確認できます。サンドボックスと本番では値が違います。

### 自分のサイトから送る

自分のサイトに「購入した商品」のようなボタンを置くと、お客様は確認コードなしでポータルを開けます。ボタンが押されたときに Cozeni がリンクを作り、SDK がお客様をそのリンクへ送ります。リンクにはポータル用の使い捨てのコードが付き、60秒で切れて1回しか使えません。

1. ボタンのリンク先を自分のサイトのルート（例：`/portal`）にします。
2. そのルートで、SDK の `portalRedirect()` を呼びます。
3. 作られたリンクへ、お客様は 302 でリダイレクトされます。

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

// 販売者のクリエイターID（cre_ で始まる。秘密ではない）
const CREATOR_ID = "cre_...";

export const dynamic = "force-dynamic";

// 押されたときに購入者ポータルへのリンクを作り、302 で送る
export function GET() {
  return portalRedirect(CREATOR_ID);
}
```

ボタンは `<a>` で作ってください。Next.js の `<Link>` は表示時に先読みしてリンクを作るため、押される前にリンクが使い切られたり切れたりします。

```tsx
<a href="/portal">購入した商品を開く</a>
```

クリエイターIDの確かめ方は上の「ポータルの URL」を参照してください。

#### 失敗したとき

- 自分のサイトで購入者の入場を確かめられない場合、`portalRedirect()` はリンクを作らず、コードの付かない購入者ポータルへ送ります。Cozeni 側にもセッションがなければ、お客様はメールアドレスと確認コードで入場します。
- リンクを作れない場合（一時的な障害など）は、503 を返します。障害のときに、お客様を入場の画面へ送ることはしません。
- 返ったリンクが指定したクリエイターや環境と合わない場合は、ログに確認を促す文を出します。`CREATOR_ID` と接続先の環境が合っているかを確認してください。

### Cozeni が送るメール

- 購入完了メールには、「購入した商品を開く」ボタンがあります。機能フラグの商品だけを購入した場合は、このボタンは出ません。
- ボタンを押すと、購入者ポータルが開きます。
- 入場していない場合は、確認コードの送り先がこのブラウザに残っていれば（購入したのと同じブラウザなど）確認コードの入力画面が、残っていなければ（別の端末で開いたときなど）先にメールアドレスの入力画面が出ます。

購入完了メールには、購入者限定ページの URL や確認コードは含まれません。商品名・販売者名と、購入者ポータルへのボタンが載ります。

## 次に読むページ

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

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

**[ポータルへのリンクを作成する API](/api-reference/customer/external-create-portal-link)**

購入者ポータルへのリンクを作る API の仕様です。

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

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

**[コマンド一覧](/integrate/cli/reference)**

クリエイターIDを確かめる `whoami` など、CLI のコマンドです。

## よくある質問

**お客様はどうやって入場しますか**

メールアドレスと確認コードで入場します。お客様は会員登録をしません。自分のサイトで入場しているお客様は、自分のサイトのボタンから確認コードなしでポータルを開けます。詳しくは [購入者の入場とアクセス判定](/features/customer-access) を参照してください。

**ポータルへのリンクを自分で送る必要はありますか**

ありません。購入完了メールに「購入した商品を開く」ボタンがあり、お客様はそこからポータルを開けます。ただし、機能フラグの商品だけを購入した場合は、このボタンは出ません。自分のサイトにボタンを置くこともできます。

**機能フラグの商品が一覧に出ないのはなぜですか**

機能フラグは、お客様が見る画面を持たないためです。

**ポータルをオフにしたり、見た目を変えたりできますか**

できません。管理画面には、購入者ポータルの設定はありません。
